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When the first issues of "USER GROUP NEWS" were compiled there was a concern that there 
would not be enough new material for the following issues in the span of three months. The 
major problem, as it turns out, was which of many articles would be printed. Still one problem 
remains! Almost all articles focus on the 8560. That is not really surprising because of the versa- 
tility of the TNIX tool set; but we don't want to ignore the owners of 8002 and 8550 systems. If 
you are an 8002 or 8550 user please take special note of the following: 

CALL FOR ARTICLES 

If you have application articles or just some good ideas, we would like to print them in the Appli- 
cations Section and or place them in the new User Group Library Section of "USER GROUP 
NEWS". A submittal form is located at the end of the Applications Section for your convenience. 

ABOUT THE "USER GROUP LIBRARY SECTION" 

We have collected a number of application programs since the last issue and we will make the 
programs reported in the User Group Library available through your Tektronix Applications 
Engineer. Separate volumes will be compiled for the 8002A, 8550, and TNIX. Each issue will 
report updates to the library and a separate total listing will be produced annually. 

John Owens 
Editor 
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TEKTRONIX and DIGITAL MICROPROCESSOR SUPPORT FOR VAX 

Tektronix and Digital E^quipment Corporation ,have just con- 
cluded an agreement to jointly market Tektronix Microproces- 
sor support tiools on the Digital Equipment VAX series of conn- 

puters. Through this agreement, Tektronix and Digital will be able to oflfer designers the most comprehensive 
set of hardware and software tools available in the industry. 

Tektronix currently offers support for the 68000/08/10, 8086/88/186, Z80, NSC800, 8080, 8085, and 6809 
microprocessors on the VAX under either VMS or UNIX 4.1bsd operating systems. Included with this support 
software is a unique interface package (ICOM40) which allows users to access the Tektronix Emulation unit from 
any terminal on the VAX; thus giving VAX users the same integrated functionality as Tektronix provides with 
their 8660 sj'stems. High level languages, Pascal and C, are available for the 68000/08 microprocessors, including 
Tektronix' unique LANDS (Language Development System) package. Tektronix provides Language Directed Edit- 
ing, Integration Control System, High Level Debug, and Chip Specific Compilers. 

For more information contact your local Tektronix representative. 

Doug Johnson Software Product Marketing Manager 
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MDP USER GROUP LIBRARY 

CALL FOR PROGRAMS FOR ALL TEK MDP PRODUCTS - NEW AND OLD 

The MDP User Group Library is here! The library is provided as a service to MDP users for collecting and distri- 
buting user-contributed software for all Tektronix Microprocessor Development Products. Library software will 
not be supported by Tektronix. However, some application engineers and customers have created some useful 
programs which may benefit others. The program works like this: 

• All users are encouraged to submit their creations to Library Manager, MDP Marketing, P.O. Box 4600, 92- 
636, Beaverton, OR 97075. All submissions will be considered and are made with the understanding that the 
software may be placed in the public domain. For your convenience, a software submission form is included 
in this issue and on the first distribution disk volume. We must have the author's name to consider a sub- 
mission, but we will withhold it if you prefer not to be contacted by anyone. Please make your entries on 
disk media. 

• We will' generally check out the programs, but no guarantees of any kind will be made. We prefer to have 
the object, source, documentation, and manual page (as applicable) submitted on a floppy disk, but we'll take 
whatever you have. If the program warrants it, we can add the documentation. 

• All accepted programs will be archived in MDP Marketing and as soon as we have enough to reasonably fill a 
disk, a new volume will be released. Copies of these disks will be available from your Tektronix Application 
Engineer. Separate distributions will be made for the 8002A, 8550, and TNDC. 

• Quarterly we will provide a listing and index of all new entries. Annually we will produce a complete catalog 
which will be distributed with "USER GROUP NEWS." Each volume distributed will also include a catalog 
listing and summary of all software included on that disk. 

The first TNIX volume is almost ready for release and includes over thirty programs, ranging from useful shell 
scripts, to complex C programs which allow binary patching of TNK files. Other useful programs are out there, 
so send 'em in! 

Greg Saville MDP Technical Support Manager 



NEW VERSIONS OF CLASS C PRODUCTS 

New versions of the Text Processing, Native Programming, and Auxiliary Utilities Packages are available. These 
versions are modified for compatibility with TNDC v.2 and correct several Software Problem Reports. There are 
change pages to the user manuals which reflect changes in installation and file content. Order information is 
available from your Tektronix Sales Engineer. 



Product Name 



Product # Upgrade Part # 



Text Processing 8560U01 020-1086-00 

Native Programming 8660U02 020-1088-00 

Auxiliary Utilities 8560U03 020-1087-00 



TNIX V.2 COMPATIBILITY 

For compatibility with TNK v.2 there are changes in on-line manual pages and installation procedures. The on- 
line manual pages are distributed with version 2 of these products instead of with TNIX as they were for version 
1. The installation procedures are modified to accommodate iristallation on previous versions of TNDC. 
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TEXT PROCESSING 

"NrofT now works with index macros (nroff -T). "Spell" now works for the options: American, British, S (hashed 
stop), and local. 

NATIVE PROGRAMMING 

Programs generated by "lex" can now link in functions from /lib/libl.a (ie, "all print", "sprint", "printable", 
"yyreject", "yyracc", "yyless", and "yywrap"). 

Updated include files for C programs are provided and are the same as supplied with TNIX v.2. These are the 
additions and deletions to /usr/include: 



Added 


Deleted 


crtdev.h 


SCCS/s.stdio.h 


mtab.h 


ar.h 


sqqpio.h 


ident.h 


sys/bootblk.h 


Ip.h 


" /cmd.def.h 


olddump.h 


" /disc.h 


sys/tiop.h 


" /error.h 




" /iopcmd.h 




" /Ip.h 




" /timeblk.h 




" /trm.def.h 





AUXILIARY UTILITIES 

"Learn" now recognizes as correct answers for TNDC that it previously recognized as incorrect (the "tail" com- 
mand was modified). 



CUSTOMER UPGRADES 

To obtain the updates, order by the part number shown in the table above. 
Rodney Bell MDP Product Marketing Manager 



10 MHZ FOR THE 68000 EMULATOR IS HERE 

An upgrade is available to increase the maximum clock frequency of the 68000 Emulator from 8 MHZ to 10 MHZ. 
The upgrade is available for ALL 68000 Emulators. 

For existing emulators, users can either install an upgrade kit, or have the emulator upgraded via a board 
exchange through Service Support. 

Bill Bevan MDP Product Marketing Manager 
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68000 PASCAL FLOATING POINT LIBRARIES 

A speeded-up version of the floating point libraries for the 68000 PASCAL is available now. If an application 
depends upon "fast" floating point, Tektronix provides it. Users who have the Software Subscription Service will 
receive this update automatically. 

Marilyn Hanson MDP Product Marketing Manager 



8560 GPIB CONTROL CAPABILITY 

When the 8560 or 8561 contains the GPIB Interface and the Category C Native Programming Package, it can 
control GPIB-compatible instruments. Specifically, it can perform the following functions: 

• enable instruments to talk 

• enable instruments to listen 

• perform serial polls of all instruments or selected instruments 

• perform parallel polls 

• anything else except pass control to another instrument. 

The C programming language allows total access to all device functions. With 3 additional commands, control 
capability comparable to a 4050 Series Graphics Computer is possible using only the TNDC shell. 

TNIX/GPIB ARCHITECTURE 

All GPIB devices are TNDC special files, and provide the same level of interface as other special files. (For exam- 
ple, the echo command works the same on a GPIB instrument as it does on a terminal.) When you install a GPIB 
instrument on the system, you can select one of 3 driver routines that tailor the special file to a specific applica- 
tion: 

• The "magtape" driver provides an interface to Dylon magnetic tape systems, 

• The "instr" driver provides a general interface that accommodates just about any instrument. 

• The "direct" driver provides total low-level control of the GPIB. It may be used if the "instr" driver is 
unable to handle a particular instrument, or it can be used to provide direct access to the bus. 

NOTE: The software documentation and the manuals refer to these drivers as "GD"s. 

All three drivers can automatically generate device addresses and perform serial polling tasks. 

The GPIB Interface itself is an intelligent board, containing an 8088 processor and RAM-based software (only the 
bootstrap code and diagnostics are in PROM). The combination of this intelligent board, and 11/23 main CPU, 
hard disk, and the TNDC operating system make this a powerful GPIB control solution. 

COMMANDS 

These commands come with standard TNDC 1.4 (or above): 

• Idgpib - initializes the GPIB Interface 

• mkgpib - install/remove/modify GPIB instruments on the system 

• statgpib - provides status information about GPIB instruments 

• miscellaneous magtape commands 

• a detailed description of GPIB special files (type "man 4 gpib") 

These commands are insufficient to control instruments from the shell. To do this, you need the following com- 
mands: 
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• gread - reads device-dependent data from a specified device 

• srq • waits for a service request on the specified device, polls the device, writes the status byte in a tem- 
porary file, and signals the parent process 

• setgpib - sets and reports the termination mode and exclusive/inclusive use of a devifce. 

The following is a copy of the man page for "exgpib". This is a command that was created while designing the 
GPIB Interface software/firmware, exgpib allows the user to do just about anything that can be done on the 
GPIB. The user interface provides full functionality. 

Name 

exgpib - exercise GPIB interface 

Syntax 

exgpib [device-name] 

Description 

Exgpib exercises a direct-type GPIB device based on a command string received from standard input. If an argu- 
ment is given it is used as the device to be exercised. If no device is specified the device /dev/ctr is used. The 
source and destination of device dependent data is initially set to standard input and output but may be changed 
with exerciser commands. 

Many commands are simply GPIB mnemonics for the command to be sent. The command list follows: 

«=STRING send STRING as device data 

:HH send HH (hex) as a character 

eoi D send char D (decimal) with EOI 



©STRING 



?D 

aD 
sD 

<FILE 
>FILE 

X 

xfer 
xfer D 

Status and data transfer control: 



send STRING as device data 
and accept a one record response. 

accept D characters (default 1) 

accept D records (default 1) 
source D records (default 1) 

set data input file to FILE 
set data output file to FILE 

external data xfer 

external data xfer [time] 



Stat 
bus 

htime D 
ptime D 

term If 
term crl 
term eoi 
term none 

adr 

adr PRI.SEC 



print device status 
print (GPIB) bus status 

set data xfer time 
set poll xfer time 

set termination mode 



print GPIB address 

set GPIB address (addresses in decimal) 
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Interface commands: 

atnt 
atnf 



set ATN 



rent 
renf 



set REN 



ifc 
ifcf 



send IFC pulse 
set IFC false 



llo 
del 
ppu 

«tl 
get 
sdc 



send universal command 



send addressed command 



cD 
taD 
laD 
saD 

unt 
unl 



send byte D (decimal) as a command 
send talk address D 
talk listen address D 
send secondary address D 

send untalk 
send unlisten 



Poll commands: 



poll turn on auto poll 

poll on turn on auto poll 

poll ofT turn ofT auto poll 



spoil 
ppoll 
sps 
spstat 


serial poll device 
parallel poll device 
print saved s-poll status 
print saved s-poll status 


srq 
mysrq 


wait for SRQ 

wait for device SRQ 


[isc commands 




V 

voff 


Verbose mode on 
Verbose mode off 


ass 
deass 


assign GPIB 
de assign GPIB 



excl set excl open 

excl off set no excl open 



quit 

q 



exit the exerciser 
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Files: 

/dev/ctr default direct gpib device. 

Diagnostics: 

A diagnostic "can't open device-name" is printed if a device or source file is requested that cannot be opened. 

Commands which are not understood are printed on standard error surrounded with question marks (?? foo ??). 

If the execution of a GPIB command fails, a message describing the failure and the returned error code is printed 
to standard error. 

Greg Gadeholt MDP Product Engineer 



SPEED OF 8560 DISK BACKUP USING GPIB OPTION 

There are approximately 64,000 blocks on the 8560's 35.6MB disk. Using the dump command to backup the 
entire disk takes about 1 hour, or an average of .5 megabytes per minute. This assumes a blocking factor of 6, 
which is the default blocking factor used by dump. Larger blocking factors will, of course, provide faster backup. 



Chuck Smith MDP Product Marketing Manager 



SUPPORTING 8001 AND 8002A CUSTOMERS 

The matrix below shows which items to order for support on an 8001 or an 8002A Microprocessor Lab. The part 
numbers listed under the columns represent manuals, software or proms for the appropriate mainframe. 





ORDER THESE PLl 


JS THESE ITEX1S OF 


i THESE ITEMS 


Mi croprocessor 


Emul ator/Probe 


8002A 


8001 


Z-80 


8300E04 


062-3511-05 


160-0163-01 




8300P04 


070-2705-01 
070-2710-01 


160-0164-01 


8085 


8300E06 


062-3760-05 


160-0165-01 




8300P06 


070-2702-01 


160-0166-01 






070-2707-01 


070-2871-01 


6800 


8300E02 


062-3735-06 


160-0004-02 




8300P02 


070-2703-02 


160-0251-00 




8300P03 


070-2708-02 


070-2713-00 
070-2961-00 


8048 


8300E10 


062-4401-04 


160-0763-00 




8300P10 


070-2611-00 


160-0764-00 




8300P11 


070-2612-00 


160-0766-00 




8300P12 




070-2865-00 
070-2473-00 


1802 


8300E0d 


062-4169-03 


160-0462-00 




8300P09 


070-2627-00 


160-0463-00 






070-2628-00 


070-2854-00 






070-2628-00 


070-2882-01 
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MEMORY BOARDS - If a user wishes to add memory to cither an 8001 or an 8002A, order the 16K memory 
board from Customer Service under part number 670-5298-02. Users can also order 32K Memory Boards nomen- 
clated as 8550F02. When the user installs an 8560F02, the emulator operation may change. A brief summary of 
the changes is presented below. 

EMULATOR OPERATING CONDITION IN 8001 or 8002A 

Z80 Must be strapped for wait states 

8085 Must be strapped for wait states 

6800 Must be strapped for wait states 

8048 No strapping necessary 

1802 No strapping necessary 

Roger Hokanson MDP Product Marketing Manager 



NEW MANUALS ORDERABLE 

8560 Series MUSDU System Users 070-4730-00 

8560 Series MUSDU Sy s tern Manage r s 

and Instruction Guide 070-0211-00 

8500 MDL Series 68000 Emu 1 a t o r 

Processor Instruction Sheet 070-4798-00 

8561 MUSDU 4-User Upgrade 

Instruction Sheet 070-1623-00 

8561 MUSDU 8-User Upgrade 

Instruction Sheet 070-1438-00 

8561 MUSDU 4-User Upgrade Option 

User Information Instruction Sheet 070-4764-00 
8561 MUSDU 8-User Upgrade Option 

User Information Instruction Sheet 070-4770-00 

Charlene Eason MDP Customer Support 
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APPLICA TIONS SECTION 



8086/88 ASSEMBLER ASSUME DIRECTIVE 

In the 8086, each memory reference is calculated by adding the contents of a segment register, which contains the 
starting address of a segment and an offset from the start of a segment. With the Tek Assembler, all offset calcu- 
lations on relocatables are done at link time. When the linker resolves the address of a relocatable symbol, it 
determines it's 20-bit address. The ASSUME directive is used to tell the assembler what values will be in the seg- 
ment registers at runtime. The assembler instructs the linker to calculate the offset by subtracting the ASSUMEd 
value for the start of the segment (also a 20-bit address) from this resolved address. If the memory reference is in 
the segment, this subtraction yields a 16-bit offset. However, if the memory reference is outside the segment, the 
linker will issue a truncation error. For more information, see the 8086/88 Assembler Specifics manual, page 9A- 
41. 

Marilyn Hanson MDP Product Marketing Manager 
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IMMEDIATE DATA IN 8088 ASSEMBLER 

Immediate data is handled in the following way by the 8086 assembler. 

If a scalar is specified as immediate data, the assembler checks that it is in the correct range (8 or 16 bits, signed 
or unsigned). 

If the immediate is relocatable, a 20-bit value is calculated by the linker. It is the ueer'$ responsibility to get this 
into a form appropriate for the instruction. The main reason for doing this is that the 20-bit value contains both 
the segment and offset parts of an address. By allowing (making) the user to handle immediate data, either part 
may be extracted and manipulated. You can use the BITS function to access either part. 

Marilyn Hanson MDP Product Marketing Manager 



SEGMENTED ADDRESSES AND THE 8560 LINKER 

If an address is defined in one module, and the user wants to use the upper 16 bits of a 20 bit address to set a seg- 
ment register in another module, use the bits function. "LO", "HI", and "BITS" operations are resolved by the 
linker when the definition of the address is contained in one module and is referenced in another module. 

CAUTION: When the linker is required to resolve the assembler function, subsequent assembler operations or 
inclusion in expressions is not allowed; i.e., the result of the linker resolved function must be used directly as in 
the following example: 

global fred 

movw ss,#bits(fred,4,16) 

If the resulting 16 bit value is needed in subsequent instructions, it will need to be entered as above again. It 
would be incorrect in the referencing module to assign the result of the bits expression to a label for later use. 

John Owens MDP Technical Support Manager 



A VAX/8560/8540 Configuration 

The following is a synergistic VAX/8560/8540 configuration: 



remote port 




HSI port 



With ICOM40 on the VAX, from a terminal connected to the 8540, the user can switch between using the 8560/ 
8640 configuration and the VAX/8540 configuration. 



config term 
{ 8560/8540 



; connects the user (8540) to the 8560 



10 
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session } 

config local 

config term i=r m=4 t=10 ; connects the user (8540) to the VAX, using 

the remote port on the 8540. 
{ VAX/8540 
session } 

Therefore, both configurations are available from one terminal! 

*«*«« NOTE ****** 

This has been tested for VAX UNIX only. 
Diane VVortsmann MDP Product Marketing Manager 



SOME TOOLS FOR THE 8560 

Jean Paul Bonsang of Tek France has provided the several very useful programs that follow. 

1 FDUMP provides a file dump (or directory) in both hex and ascii format. The format of the output is 

exactly like the 8650 fdump command. The source for the fdump command follows: 

/* program to dump a file ♦/ 

/* fdump 16-mars-83 jpb/france */ 

#include<stdio.h> 

char Iine[80l; 

char table|] = "0123456789abcdef"; 

int nl, c, i, x; 

long n; 

FILE 'inrp; 

main (argc, argv) 
int argc; 

char ♦argv[]; 

{ 

if (argc > 2) { 

printfC Usage : fdump [file]\n"); 
exit(l); 

} 

if (argc =:- 2) { 

if ((infp = fopen(argvll], "!"))== NULL) { 
printfCInexisting file \n"); 
exit(l); 
} 
} 
if (argc == 1) { 

infp=stdin, 

} 

n =- 0; 
nl=24; 
raz(); 

while ((c = getc(infp)) != EX)F) { 
if (nl == 24) { 

printfC \n"); 

printfC 0123456789abcdef Vn"); 

printf(" \n"); 

nl = 0; 

} 

binhex(c); 

if ( c < 32 II c > 128) { 
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else 



liDeiX + -f 



linex++ = c; 





} 










i + + 










.f(, 


> 


67) { 
printfC^syn", 
n ^" n •+ 16 ; 
nl ^ nl -4 1; 

ra7(); 


line); 


} 

if (l 1 


} 

= 11){ 
prin 


tfC 


"'?os\n'', line); 





} 
} 

/* procedure binhex */ 

int binhex(tmp) 

{ 

int h, I, 

h = tmp/16; 
I = tmp%16; 
line|i++l = tablejhl; 
line|i-t-+j = table[l]; 

} 

/* procedure raz •/ 

int raz() 



int xl, xml, xmh, xh; 

long nn, nnn, 

for ( i = 0; i < 78; i++) { 
lineji] = ' '; 

} 

liDe|78i == '\0'; 

I = 0; 

nn == n/266; 

nnn = nn/256; 

xl = n9c256; 

xml = nn<>c266; 

xmh = nnn^'266; 

xh = nnn/266; 

binhex(xh), 

binhex(xmh): 

binhex(xml); 

binhex(xl), 

X = 61; 

i = 11; 



} 



KEY programs CT8500 keys directly or via a file. The source follows: 

#include <stdio.h> 



#define 


LF 10 


#define 


CR 13 


#define 


ESC 27 


#de6ne 


US 31 


main 


(argc, argv) 


int 


argc; 


char 


♦argv[l; 


{ 






int i, c; 




char keyc, stnngllOO); 




keyc='G'; 




.f (argc != 2) { 




fprintflstderr.'Usage: key {nbre} <cr>\n''); 




exit(l); 
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} 

sscanf(argv[l),"%d",&i); 
.f(. <1 ||.>8){ 

fprintf(3tderr,"Key between (1 — 8)\n*); 

exit(l); 

} 

keyc=keyc+i; 
fprintflstderr,"? "); 
stnng!0]=ESC; 
stringilj = '9'; 
stringi2)=ESC; 
stringisj^keyc; 
i=4; 
c=l; 

while((c=getc(stdin)) != '.') { 
if(c=-LF){ 
c=CR; 

} 

string[i++l=c; 



} 



string[i++]==US; 
string[iH-+)='\0'; 
printf(''%s'', string); 



ACCOUNT provides a history of a users login and logout activity. The source follows: 

/* programm account jpb france 17/2/83*/ 
#include <stdio.h> 

char console|lO], oconsolellO], nameflO], oname[lO], login[30], logout|30]; 

int ident, test, flag, ptr, nl ; 

long dh, dmn, cumul, delta, otime, ttime; 



FILE 
main 
int 
char 


*infp; 
(argc, argv) 
argc; 

♦argv[]; 




{ 


if (argc !- 2) ( 

printfC Usage : account user <cr>\n"); 
exit(l); 

} 

if ((infp = fopen ("/usr/adm/wtmp","r")) == NULL){ 

printfCFile : /usr/adm/wtmp not found\n"); 

exit(l); 
\ 






f 

printfC \n\n''); 
printf('' 
flag=10; 
cumul=0; 


USER NAME : %s\n\n",argv[l]); 




nl=0; 

test=10; 

de!ta=0; 






y}i \ii\.i\ ———————————————— 

printf("| LOGIN 
printfj" 1 TIME | 


1 LOGOUT"); 
TOTAL |\n"); 



\n" 



LOOPl: wbile(flag != NULL ) ( 

fscanf(infp ,"%8s%8s", console, name); 
flag=fread(&ttime, 4 , 1, infp); 
if ((ident=strcmp(name, argv[l])) == ){ 
ptr=ctime(&ttime); 
strcpy(login, ptr); 
login|24)='\0'; 
8trcpy(oconso!e, console); 
otime=ttime; 
while(test != 0) { 

fscanf(infp,"%8s9S8s", console, name); 
flag=fread(&ttime, 4, 1, infp); 
test=strncmp(console, oconsole, 4); 
if (test == ) { 
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ptr=ctiine(&ttime); 
8trcpy(logout, ptr); 

loKout[24]='\0'; 
test=10; 

delta=ttime-otime; 
delta=delta/60; 
cumul=cumul+delta.i 
dh = cumul/60; 
dmn = cuinul%60; 
priDtfCI %s I %s |%4ld mn |%3ld h%3ld mn |\n", login, logout,delta,dh,dmn); 

printf(" -' \n"); 

nl=Dl+l; 
goto LOOPl; 

} 

if (flag == NULL) { 
exit(l); 



} 
} 

if(Dl == 0) { 

printf(''\n''); 

printfC No infonnation for %s \n'' ,argv[l]); 



FNLA.N is identical to the TNEX man command in function, but the manual content is displayed much fas- 
ter. The command normally displays a page at a time and inquires for next page displays. The -n option 
suppresses the prompting for each page. The source follows: 

/• programme fman jpb 10/5 /83 •/ 

#include<stdio.h> 

#define TRUE 1 

#define FALSE 

#define LF 10 

^define CR 13 

#define MAX 23 /* max length of a page*/ 

char table'ii = "0123456789"; 

char post [) ==^ ".1"; 

char dirij = "/usr/man/catl/"; 

int q_flag; /* question _flag */ 

int s_flaBi /* short Jag ♦/ 

int d_flag; /* debug_flag ♦/ 

char line[l00l; 

FILE 'inrp; 



main 


(argc, argv) 


int 


argc; 


char 


•argvj], 


{ 






char file[l00l; 




int test, X, flag; 




char »pname; 




test = 0; 




X =1; 




!_flag = FALSE; 




q_flag = TRUE; 




d flag = FALSE, 




/* 




* examine the switches 




*/ 




pname = ♦argv++; 




while (*argvjO] == '-') { 




while ( ♦( ++( ♦argv ) ) ) { 




switch (**argv) { 




case 'd': 




d_flag = TRUE; 




break; 




case 's': 
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8_flag = TRUE; 
break; 



default: 



q_flag = FALSE; 
break; 

priDtf("Usage ; fman l-nsd] [chapter] {command}\n"); 
cxit(l); 



argv+ + ; 
argc--; 
} 

if (argc < 2 II argc > 3) { 

printf(" Usage ; fman [-nsd] [chapter] { command }\n"); 
exit( 1); 

} 

if (argc == 3 ) { 

sscanf(argv[0] , "%d", &x); 

dirll2| = tablejx]; 

postllj = tablefx]; 

strcpy (file , dir); 

strcat (file , argvjl]); 

strcat (file , post); 

if (d.flag == TRUE) { 

printf ("Seeked file : %s\n",file); 

} 

if ((infp = fopen(file, V)) != NULL) { 

flag = displayO; 

exit(l); 
}else { 

printf("\n$Command not found. \n"); 

exit(l); 
} 
} 

for (x = 1 ; X < 10 ; x++) { 
dir[l2l = tablejx]; 
postjl] = table[x]; 
strcpy (file , dir); 
strcat (file , argvjol); 
strcat (file , post); 
if (d.flag == TRUE) { 

printf ("Seeked file : %s\n",file); 

} 

if ((infp = fopen(file, V))!= NULL) ( 
test = 1; 
if (s_flag == TRUE) { 

fgets(line,80,infp); 
fgets(line,80,infp); 
fgets(line,80,infp); 

} 

flag = displayQ; 
flag = fclose{infp); 
} 
} 
if (test == 0) { . 

printf(''\n$Command not known . \n"); 
} 
} 

/♦ 
• sous programme display 

.•/ 

int displayO 

{ 

char 'ptr; 

int c, nl; 

nl = 0; 

printfCyn"); 

while ((ptr = fgets(line, 80, infp)) != NULL) { 

if (lineJO] == 'D' && s_flag == TRUE) { 
exit(l); 
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} 

printfC^s", line); 

if (nl == MAX && q_flag == TRUE) { 

priDtf("\n$[Enter CR to continue] '); 
c = getchar(); 

printf("R \r"); 

nl = 0; 
} 
} 

printf("\n''); 
return(l); 
} 

Jean Paul Bonsang Tek France 



TNIX CONFIGURABILITY - WHEN AND WHERE 

Since the advent of TNK 1.4 and 1 mbyte memory for the 856X, TNDC configurability has not been clearly 
understood by users. The TNK manual "8660 Series System Manager's operational and installation guide" (Part 
No. 070-0211-00) for TNIX 2.0 provides an excellent description of TNK configurability. 

Earlier versions of TNK did not provide TNK buffer configurability. With the introduction of larger memory, 
GPIB Tape Controller, Expansion disks, and the 8561, a default configuration could not meet all needs. 

The "cvt" command can be invoked by the system superuser (root) or with standalone utilities to provide the 
configurability needed. The following is a brief summary of when to use cvt, and how to use it. 

The default TNK configuration, as supplied, is satisfactory for most needs. The only need to change TNK via 

cvt would occur when: 

1. an 8560(61) is restored with a set of dump disks from a 8561(60) or 

2. a 1/2 mbyte or 1 mbyte memory is installed and a large number of processes will be created or 

3. TNK file or inode errors occur or 

4. several disk intensive jobs running or 

6. a number of disk intensive jobs run much slower than expected or 

6. no apparent gain in system performance with increased memory. 

If a dump series is used from an 8560(61) to restore an 8561(60), the standalone version of cvt will be required to 
set swplo to 65000(8660) or 24360(8561) and nswap to 4500(8560) or 2250(8561). TNK will now be able to run. 
Using a 8660 dump series to restore an 8561, even when smaller than 13 disks, may not work at all. The TNK 
restore disks provided with the 8561 is a 8560 dump disk set; thus restoring an 8561 with the supplied disks will 
require the above step before the system will boot up. 

If any of the other conditions are met, then the following is recommended as a starting point. 

This must be done first to make room for the following 



moun t 


1 


buffer 


30 


inode 


80 


file 


96 


text 


35 


swapmap 


90 


cor emap 


120 



The following relationships must be observed: 
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• File must be greater than inode and 

• Swapmap must be greater than or equal to proc and 

• Proc must be greater than or equal to text and 

• mount must be greater than or equal to 1. 

To make the above changes, use the cvt option "-w". Note: cvt does not prompt the user. The current settings 
can be viewed by entering an "*". A control D will terminate the cvt command. The system will have to be res- 
tarted to use the new settings. 

John Owens MDP Technical Support Manager 



INCLUDING MATH LIBRARIES IN C PROGRAMS 

Including math libraries in C programs is not automatic with the normal cc invocation. To gain access to the 
math functions, use the -Im option at the end of the command line. The following example shows how to compile 
and run a short example using a square root function. 

C program 'sqrt.c' 

#include <math.h> 
main() { 
float i=2.0; 
printf(" sqrt(2.0) = %fO,sqrt(i)); 
} 

Compilation: 
cc sqrt.c -Im 
Execution: 

$ sqrt 
sqrt{2.0) = 1.414214 $ 

By the way, the -Im option is not documented under "cc" because it is a loader flag. Use "man Id" or see "Id" in 
section 6 of the TNK System Reference Manual. 

Greg Saville MDP Technical Support Manager 



EXTENDING THE LINKER SYMBOL CAPABILITY 

Several methods of efl'ectively extending the global symbol table capability of the linker are presented here. 
"Module Grouping" and "Data and Declarations Grouping" are the simplest methods to implement. The "Section 
Names" method will only provide a limited improvement, but is easy to implement. "Separation of Load Files" is 
the most effective method provided, but requires significant effort to implement. 

Module Grouping 

Typically a large number of modules are generated to describe an executable program. If the modules which pri- 
marily reference each other are grouped together, the number of globals can be significantly reduced without hav- 
ing to combine the modules in a common file or sacrifice code modularity. That is, the symbols which are not 
referenced outside the collected group of modules should not be global. The modules can remain separate and are 
referenced for assembly in a new (global) module which is simply a series of "include" directives. 

Such a file might look something like: 
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include 


lOl.src 


include 


I02.src 


include 


lOdata.src 



This is functionally equivalent to concatenating all the grouped files into a common file or entering an assembler 
command which lists all the group source files on the command line. Such as: 

asm object list lOl.src 102. src lOdata.src ... 

The module grouping method will reduce the number of globals and filenames which the linker must store, pro- 
vide better documentation, and minimize the file space required. 

Data and Declarations Grouping 

Often when organizing a program into manageable units (modules), it is logical to place data and location declara- 
tions in a common module(s). This is the case especially when the assignments relate to the configuration of the 
hardware and memory organization which are usually the most subject to change. Data structures which are 
referenced from many locations in the program are also combined into a module(s) for accessibility and maintaina- 
bility. Generaly these declarations are referenced from many locations in the code, thus they are declared global. 

The assembler allows the declaration of a "common" section. If the above types of declarations were placed in a 
"common" type section and referenced by each module that needed access to the values via the "include" direc- 
tive, the labels would not be global. When using include to reference a file more then once, the file cannot contain 
global directives. The linker assumes that all "common" sections of the same name are, in reality, multiple 
descriptions of one logical section as in the common directive in Fortran. 

The use of this assembler feature will greatly reduce the number of globals required. 

Section Names 

Often the separation of code between modules is made on the basis of the length of the code rather then the func- 
tion provided by the code. If this is the case, the modules which contain a single logical function or collections of 
functions can use the same section name in multiple modules and at link time the sections will be concatenated in 
the order that the linker command file specifies the file names. Caution: The value associated with the section 
name will be the address of the first of the concatenated sections. Avoid using the section name as a label in the 
modules which contain portions of the section's descriptions (code). 

Section names are also global variables; thus, multiple sections with the same name will conserve global symbol 
space. 

Separation of Load Files 

If the modules generated can be divided into satellite groups of modules that are collectively standalone, and if 
the code contained in each group is primarily called or referenced by a core group, each satellite group and the 
core group may be linked independently. The resulting load files are independently loaded, thus the programmer 
must locate the groups carefully in order that gaps and overlaps in code are not generated. 

Three link passes are required to build the final load files. The first pass of each group is used to establish the size 
and location of its sections. The second pass using the -r option is used to locate the sections. The third pass is 
used to link each of the groups using define directives to resolve the globals that remain undefined. 

The resulting load files can be loaded in any sequence. 

John Owens MDP Technical Support Manager 
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USE OF PRINTER CAPABILITIES WITH NROFF 

The files contained in /usr/lib/term contain specific printer implementations that can be used with nroff. All too 
often, those provided are not suited to the printer that you may have available. The following source with com- 
ments will provide the foundation for developing a configuration for other printers. 

The following is an expanded source file and procedure to install a "taba" file for a Florida Data printer 120/130. 
The "Native Programming Tools" software must be available to compile the source provided. 

Two files are required: 

1 A file (tabFD.c) which contains the structure definition of the modes of operation, and the character set fol- 
lowed by the code that will cause the printer to assume the selected modes, and an include reference to the 
second file. 

2 A file (code.FD) that contains the code required to cause the printer to print the nroff supported character 
set. 

#define I^3CH 24 

/* 

FLORIDA DATA 120/130 
nroff driving tables 
width and code tables 

•/ 

struct { 

int termtype; /'TEK*/ 

i nt bs e t ; 

int breset; 

int Ho r ; 

int Vert ; 

i n t New I i n e ; 

int Ch a r ; 

i n t Bm ; 

i nt Ha I f I i ne ; 

int Ad j ; 

char*twinit; 

char •t wrest; 

char * twn I ; 

char •hi r ; 

char •hlf ; 

char •fir; 

char •bdon ; 

char •bdof f ; 

char •ulon; /•TEK«/ 

char •uloff; /•TEK*/ 

char*ploton; 

char *plotoff; 

char •up; 

char •down ; 

char^right; 

char •left; 

char •codetab [256-32] ; 

int I sz ; 

} t = { 
/•termtype^/ 100, /•TEK - 100 means 'not specially supported*^/ 
/•bset^/ 0, /• binary value used to set(mask) the port mode •/ 
/♦breset^/ 0, /• user to reset the port mode at end of printing •/ 
/*HoT*/ INCH/60, 

/•Vert*/ INCH/48, 
/•Newline*/ INCH/6, 
/•Char^/ INCH/ 12, 
/♦Em*/ INCH/12, 

/♦Halfline*/ INCH/12, 
/•Adj«/ INCH/ 12, 

/•twinit^/ " \0331 \0331 \0331 \0331 
\0331 \0331 \0331 \0331" , 



/• Initialiie the printer for text writing/ 
/• reset the printer after c omp letion of i$. 



/•twrest^/ "\014\033\015P'' , 
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/•twnl •/ 

/•hir./ 

'-h\f*/ 
f I r»/ 
bdon*/ 
bdof f*/ 
u I on •/ 
ulof f*/ 
pi ot on */ 
pi otof f ♦/ 
up*/ 
down*/ 
right*/ 
'eft*/ 



"\0l5\n' 
»\033D' . 

•yoaau" , 

•\033\n" 
"\0 3 3O* , 
"\033&" , 
»\033E" , 
"\033R" , 
''\0333'' , 
•\0334" , 
"\033\n* 
''\n" . 



/*left*/ 
/*codetab*/ 
#i DC I ude * code 
) 



•\b" . 



FD" 



• text new line •/ 

/•move 1/2 line np toward top of page •/ 
/* move 1/2 line down on page */ 
/• move one line toward the top of page •/ 
/* start bold mode printing */ 
/• terminate bold mode printing */ 
/* start underline mode printing */ 
/* terminate underline mode printing */ 
/* start printer pi ot (graphi cs ) mode •/ 
/* terminate graphics mode */ 
/• move up one line •/ 
/• move down a line •/ 

/• move one position right /* 
/# move one position back /* 

/• Char, set •/ 



The second file referenced above as "code.FD" follows. Note that the printer is capable of more than is described 
here. However, the files as shown (in two column format) are sufficient to meet our needs. 



"\001 ", 


/♦space*/ 


"\00l!", 


/*!*/ 


"\001\"', 


/•"•/ 


"\001#", 


/♦#*/ 


"yoois", 


/*$*/ 


'•\001%", 


/»^o*/ 


"\001&", 


/*&*/ 


"\001'", 


/*' close*/ 


»\001(", 


/•(•/ 


''\001)", 


/*)•/ 


»\001*'', 


/.../ 


''\001+", 


/*+*/ 


"\001,", 


/*,*/ 


"\001-", 


/*- hyphen*/ 


"\001.», 


/••*/ 


"yooi/", 


/•/•/ 


"\2010", 


/*o./ 


''\2011", 


/*!•/ 


•\2012", 


/*2*/ 


''\2013", 


/*3./ 


"\2014", 


/*4*/ 


"\2015", 


/.5*/ 


"\2016", 


/*6*/ 


"\2017", 


/*7*/ 


"\2018", 


/*8*/ 


"\2019", 


/*9./ 


"\001:", 


/*:*/ 


''\001;", 


/*;•/ 


"\001<", 


/*<*/ 


"\001=", 


/*=•/ 


"\001>", 


/*>*/ 


"\001?", 


/♦?*/ 


"\001@", 


/*@«/ 


''\201A", 


/*A*/ 


"\201B", 


7*B*/ 


''\201C", 


/*C*/ 


"\201D", 


/*D./ 


"\201E", 


/.E*/ 


"\201F», 


/.F*/ 


"\201G», 


/*G*/ 


»\201H", 


/*H*/ 


"\20ir, 


/*!*/ 


•\201J", 


/*J./ 


"\201K", 


/*K*/ 


"\201L", 


/*L*/ 


"\201M", 


/*M*/ 


"\201N», 


/*N*/ 


»\20lO", 


/*0*/ 


"\201P", 


/.p./ 



,20 IQ", 

,201R", 

201S", 

201T", 

20 lU", 

201V", 

20 IW", 

I2OIX", 

,201Y», 

,201Z", 

.00 1[", 

,001\\», 

^001)", 

,oor", 

iOOlJ, 
.001", 
,20 la", 
201b", 
201c", 
,201d', 
201e", 
20ir, 
.20 Ig", 
.201h", 
,20 li", 

,:oij", 

,201k", 

,2011", 

,201m", 

,20 In", 

,2010", 

,20 Ip", 

201q", 

20 Ir", 

2018", 

20 It", 

i201u", 

,20 Iv", 

,201w", 

,20 Ix", 

,20 ly", 

,201i", 

.001{", 

.00 Ij", 

lOOl}", 

,001" ", 

,000\0", 

001 



^00l\033Wo\033& 



/*R*/ 

/*s*/ 

/•T*/ 
/*U*/ 

/*v./ 
/•w*/ 
/.x*/ 

/.Y*/ 
/•Z*/ 

/•!•/ 

/•\*/ 
/•]•/ 
/•'•/ 

/•_dash*/ 

/•' open*/ 

/.a./ 

/*b./ 

/.c./ 

/•d*/ 

/.e*/ 

/.f./ 

/*h./ 
/•i*/ 

/•J*/ 

/.k*/ 

/*!*/ 

/•m*/ 

/*n*/ 

/•o*/ 

/•pV 
/•q*/ 

/*r*/ 
/*s*/ 
/*t*/ 
/.u*/ 
/*v./ 
/*w./ 
/•x*/ 

/•y/ 

/•I*/ 
/•{•/ 
/•I*/ 
/•}•/ 
/•■•/ 

/•narrow sp*/ 
/* hyphen*/ 



/*bullet*/ 
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•\oo2\ir. 


/•square*/ 


"\002--", 


/♦3/4 em*/ 


"\001_", 


/•rule*/ 


"\oo3r/r, 


/.1/4*/ 


"\003l/2", 


/•1/2./ 


"\003.3/'l", 


/•3/1*/ 


'•\001-", 


/•minus*/ 


''\202fi", 


/•fi./ 


"\202fl", 


/•fl»/ 


"\202flr, 


/•ff./ 


•\203ffi", 


/•ffi»/ 


•\203ffl", 


/•«•/ 


'•\001\033Do\033U", / 


'\001|\b-", 


/•dagger*/ 


•\001l\bo", 


/• section*/ 


'•\001'", 


/•foot mark^/ 


"\oor", 


/•acute accent^/ 


'•\001'*, 


/•grave accent*/ 


"\001 ", 


/*underrule*/ 


"\001/", 


/♦slash (longer)*/ 


''\000\0", 


/*half narrow space*/ 


"Vooi ", 


/*unpaddable space*/ 


"\000\0", 


/*alpha*/ 


''\000\0", 


/•beta^/ 


''\000\0", 


/•gamma*/ 


"\000\0', 


/•deltas/ 


"yOOKyb-", 


/•epsilon^/ 


'\000\0", 


/*Zti3L*/ 


"\000\0", 


/•eta^/ 


''\001O\b-", 


/•theta^/ 


''\001i", 


/•iota*/ 


"\001k", 


/•kappa*/ 


''\000\0", 


/*lambda*/ 


''\000\0', 


/*mu*/ 


"\000\0", 


/*nu*/ 


»\000\0", 


/*xi*/ 


''\001o", 


/•omicron*/ 


"\000\0", 


/*pi*/ 


''\000\0", 


/♦rho*/ 


"\000\0", 


/•sigma*/ 


•\ooo\o", 


/•tau*/ 


"\001v", 


/•upsilon*/ 


»\001o\b/", 


/*phi*/ 


"\001x", 


/*chi*/ 


"\eOOO/0". 


/*psi*/ 


"\000\0", 


/*omega*/ 


''\000\0", 


/*Gamma*/ 


"\000\0", 


/•Delta*/ 


"\00lO\b=" 


/*Theta*/ 


''\000\0", 


/*Lambda*/ 


nooiWb/", 


/*Xi*/ 


''\000\0", 


/•Pi*/ 


"\000\0", 


/•Sigma^/ 


''\000\0", 


/**/ 


''\001Y", 


/•Upsilon^/ 


''\001o\bl\bl'' 


, /•Phi*/ 


"yoooyo", 


/•Psi^/ 


''\000\0", 


/•Omegas / 


"Voooyo", 


/•square root^/ 


"\000\0", 


/•terminal sigma*/ 


"\000\0", 


/•root en*/ 


•\001>\b_", 


/*>=*/ 


"XOOKXbJ, 


/*<=*/ 


•\001=\b_", 


/•identically equal*/ 


"\001-", 


/•equation minus*/ 


"\ooi=\b- " 


/♦approx =♦/ 


''\000\0", 


/*approximate8*/ 


"\001==\b/", 


/♦not equal*/ 


''\002->", 


/•right arrows/ 


"\002<-", 


/•left arrows/ 


"\00li\b'", 


/•up arrows/ 


»\000\0", 


/•down arrow*/ 
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"\001 


=*, /*equation equal*/ 


'\001x*, /*multiply*/ 


»\001/', /*divide*/ 


•\ooi 


+\b_", /•plus-minus^/ 


•\001U", /*cup (union)*/ 


•\000\0", /*cap (intersection)*/ 


•\000\0", /*8ub8etof*/ 


•\000\0", /•superset of*/ 


* \000\0" , / ♦improper s ubset * / 


•\000\0", /• improper superset*/ 


•\002 


Bo", /•infinity^/ 


•\000\0", /•partial derivative*/ 


'•\000\0', /'gradient*/ 


•\000\0", /•not*/ 


•\000\0*, /•integral sign*/ 


"\000\0*, /*proportional to*/ 


"\000\0", /*empty set*/ 


■\000\0", /*angstrom*/ /*TEK - new*/ 


"\001 


+*, /♦equation plus^/ 


•\001r\bO", /*registered*/ 


"\001c\bO', /*copyright*/ 


"\001 


", /•box rule •/ 


"\001c\b/", /*centsign*/ 


»\00l|\b=». /•dbl dagger*/ 


•\002 


= >', /•righthand^/ 


"\002 


<=», /•lefthand^/ 


"\001 


»", /•math • •/ 


*\000\0", /*bell system sign*/ 


»\001 


", /*or (was star)*/ 


'\00lO', /*circle*/ 


"\001 


" , /*left top (of big curly)*/ 


»\001 


/*left bottom*/ 


•\ooi 


/•right top*/ 


"Vooi 


/•right bot*/ 


•\ooi 


', /•left center of big curly bracket^/ 


"\001 


', /'right center of big curiy bracket^/ 


"'^001 


", /'bold vertical^/ 


"\001 


", /'left floor (left bot of big sq bract)^/ 


'\001 


/•right floor (rb of ")♦/ 


"\001 


/•left ceiling (It of ")♦/ 


"\001 


/•right ceiling (rt of ")♦/ 


"\001 


", /'TEK - paragraph sign^/ 


'\001 


", /•TEK - trademark sign^/ 


"Vooi 


*, /♦TEK - double underline^/ 


'\001 


/•TEK - logical and^/ 


'\001i 


ir", /'TEK - logical or^/ 


"\000 


'}; /•TEK - tall line character^/ 
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After modifying the files to reflect the capabilities of your printer, compile the first file, 
cc -s -n -o tabPD.c -O tabaFD 

The file should then be located in /usr/lib/term. Note, if you use the IpXr command to print the file the printer 
deamon will remove most control characters. Thus, until a new deamon (Ipd) is available, the file must be sent to 
the device. 

cat out. file >/dev/lpX 

The command to create the output file would be: 

nrofT-ms-TFD <ms.file >out.file 

John Owens MDP Technical Support Manager 



PDB FOR PAYMENT LEARNING GUIDE DEMONSTRATION RUN 

The following listings have been prepared which contain working files for Z8000, 68000, and 8086 payment.ps 
under PDB. There are some confusing and erroneous things in the manual, but if a little time is spent working 
through the appropriate example with the assistance of these notes, you should be able run them successfully. 

Z8001 

These listings contain a working set of files to run the Z8001 payment.ps pdb learning guide demo. Note that a 
new -.is and -.ic file are used to enable pdb to run correctly. To run the demo, invoke the file setup by: . setup 
<cr> to initialize. Next run the command file payment.cmd to compile, ics, link, and pdb the program. The file 
payment.log shows the working output of the pdb execution. 

Notes: 

The recommended configuration is terminal-8540-8560. If using the 8540 remotely, a terminal is still required on 
the 8540 to run this program. 

The zBK library requires entering a decimal point for real number input, so you must enter 500.0 15.0 12 instead 
of 500 15 12 as the manual shows. 

The modified /lib/zSOOl/sdefault.is which must be used is called payment.is for ics and payment.ic for the link- 
age. See the payment.cmd file for proper invocation of the compiler, ics, link, and pdb. 

Z8K pdb does not currently work on an 8550 in term mode with the 8560. 

setup - initialization comnnand file, modify as required 

: z8001 Pascal setup 

: execute this by: ' . setup <cr> ' 

uP=28001 

TERM=ct8500 

LDECONFIG=/usr/lib/lde/lde.$TERM.cfg 

export uP TERM LDECONFIG 

sel $uP 

al OfTfT 

reset 

payment.cmd - compile, ics, link, and pdb command file 

set -V 

: 28OOI payment.ps demo run 

: assume setup run already 

pas -dvslo payment.po payment.ps >payment.pl 

ics -olv payment.is 
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link -d -o payment. lo -c payment.ic 
pdb -V payment.lo 



payment. is - ics source file 

PAS CAL _CONF I CURAT I ON 

HARIA\ARE_CONF I CURAT I ON 

EXECUTION.MODE 

EMULATOR.ADDRES S_ SPACES 

INSTRUCT I ONS.RC^ 

CONSTANTS_R(»^ 

GLOBAL _VAR_RAM 

HEAP_STACK_RAM 

RESET.MENfORY 

D^'NAMIC.RAM 

SERVICE_CALLS 

SOFTWARE.CONF I CURAT I ON 

MODULE 

LIBRARY 

FLOAT I NG_PO I NT_ SUPPORT 

FILE. SUPPORT 

ERROR_HANDLING 

I NTERRUPT.CONF I CURAT I ON 

FAULT_NOT I F I CAT I ON 

RESTART.LABEL 

END 



payment pdb test 
Z 8 001, SEGMENTED 
SYSTEM, SYMBOL I C.DEBUG 
SEPARATE 

(00012H,0003FHJ , (00060H, 07FFFHJ 
(08000H,08FFFH) 
(09000H,0D7FFH1 
(0D800H,0FFFFH) 
YES 
NONE 

40H,0FFF0H 

/usr/gregs/Pascal /Z8001 /Payment /payment . po 
NONE 
NONE 
YES 

DEFAULT 
DEFAULT 

UNIMPL_ INSTR.TRAP , SYS TEM.CALL .TRAP 
PASCAL .RTS 
PASCAL.BECIN 



payment.ic - linker conmand file 

-0 paymen t . i o 

-m INSTRQQ.ROM=04000012H-0400003FH 04000060H-04007FFFH 

-m CONSTQQ.R(M=01008000H.01008FFFH 

-m SRBVQQ.RAM=01000040H-0100005FH 

-m DATAQQ.RAM=O1009 000H-0100D7FFH 

-m ZZRESET\^QQ.R(M=04000002H.04000007H 

-L class=INSTRQQ range INSTRQQ.ROM 

-L class=CONSTQQ range CONSTQQ.ROM 

-L class=SRBVQQ range SRBVQQ.RAM 

-L c 1 a s s=£)ATAQQ range DATAQQ.RAM 

-L class=^ZRESETVQQ range ZZRESETVQQ.RO^ 

-D HEAPBASEQQ=0100D800H 

-D STKBASEQCHJIOOFFFFH 

-D SVCLOCZZ=0FFF0H 

usr/gregs/Pascal/Z800 1 /Paymen t/paymen t. po 
1 ib/z8000/pas. conv, se gm 
1 ib/z8000/pas.hi io. se gm 
1 ib/z8000/pas. fpsimr4. segm 
1 ib/z8000/pas. rts. se gm 
.err.se gm 
. r t s , s e gm 
. e r r . s e gm 
. p o s i . s e gm 
. conv. s e gm 



1 ib,/z8000/pas 
1 ib/z8000/pas 
1 ib/z8000/pas 
1 ib/z8000/pas 
1 ib/z8000/pas 
PASCAL.BEGIN 
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payment. log - program execution log 

start log: Sat Jul 9 13:43:33 PDT 1983 

# 1 cad "payment . 1 o" 

# go 

Enter loan_amount i n te r es t_r ate and numbe r_of_payment s 
500.0 15.0 12 

Payment # Principal 



1 

2 

3 

4 

5 

6 

7 

8 

9 
10 
11 
12 
13 
t e rmi nat d 



461 

421 

381 

341 

300 

259 

217 

175 

132 

88 

44 







12 
76 
90 
54 
68 
31 
43 
01 
07 
60 
57 
00 
00 



Payment 
Pr i nc i 
38 
39 
39 
40 
40 
41 
41 
42 
42 
43 
44 
44 




on 
pal 
.88 
.36 
.86 
.36 
.86 
.37 
.89 
.41 
.94 
.48 
.02 
.57 
.00 



Interest Accumulated 





Interest 


6.25 


6.25 


6.76 


12.01 


5.27 


17.29 


4.77 


22.06 


4.27 


26.33 


3.76 


30.09 


3.24 


33.33 


2.72 


36.05 


2. 19 


38.23 


1.65 


39.89 


1.11 


40.99 


0.56 


41.55 


0.00 


41.55 



Pr ogr am 
^ reset 

# break payment#25 after 12 

# break 
Name Us 



SWl 
HWl 

m/2 

TTAl 

TTA2 

TTA3 

TTA4 

# go 

En te r 

500.0 



age Kind 
ed X 
ee R/W 
R/W 



ee 



Us 

Fr 

Fr 

Free R/W 

Fr 

Fr 

Fr 



Ad d r e s s 

PA\MENT#25 SO: 001660 



after 12 



ee 
ee 
ee 



R/W 
R/W 
R/W 



1 oan_amoun t 
15.0 12 
Payment # Principal 



i n t e r es t_r at e and numbe r_o f_payment s 



1 

2 

3 

4 

5 

6 

7 

8 

9 

10 

11 

12 

SWl: Used X 

^ principal 

PRINCIPAL - 1. 

# log 

stop log: Sat 



461 

421 

381 

341 

300 

259 

217 

175 

132 

88 

44 





12 
76 
90 
54 
68 
31 
43 
01 
07 
60 
57 
00 



Payment on 

Principal 

38.88 



Interest 



Accumu 
Int 



PAYMENT#25 



39 
39 
40 
40 
41 
41 
42 
42 
43 
44 
44 
SC: 



36 
86 
36 
86 
37 
89 
41 
94 
48 
02 



25 
76 
27 
77 
27 
76 
24 
72 
19 
65 
11 



i 57Breakpo i n t Encounte 
001660 



1 ated 
e r e s t 
6.25 
12.01 
17.29 
22.06 
26.33 
30.09 
33.33 
36.05 
38.23 
39.89 
40.99 
red : 



991271E-03 



Paymen t 

45. 13 
45.13 
45. 13 
45. 13 
45. 13 
45. 13 
45. 13 
45. 13 
45. 13 
45. 13 
45. 13 
45. 13 
0.00 



Paymen t 

45. 13 
45. 13 
45. 13 
45. 13 
45. 13 
45.13 
45.13 
45. 13 
45. 13 
45. 13 
45.13 
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Z8002 

These listings contain a working set of Bles to run the Z8002 payment.ps pdb learning guide demo. Note that a 
new -.is and -.ic file are used to enable pdb to run correctly. To run the demo, invoke the file setup by: . setup 
<cr> to initialize. Next run the command file payment.cmd to compile, ics, link, and pdb the program. The file 
payment.log shows the working output of the pdb execution. 

Notes: 

The recommended configuration is terminal-8540-8560. If using the 8540 remotely, a terminal is still required on 
the 8540 to run this program. 

The z8K library requires entering a decimal point for real number input, so 500.0 15.0 12 must be entered instead 
of 500 15 12 as the manual shows. 

The modified /lib/z8002/sdefault.is which must be used is called payment.is for ics and payment.ic for the link- 
age. See the payment.cmd file for proper invocation of the compiler, ics, link, and pdb. 

Z8K pdb does not currently work on an 8550 in term mode with the 8560. 

setup - initialization command file, modify as required 

: z8002 Pascal setup 

: execute this by: ' . setup <cr> ' 

uP=z8002 

TERM=ct8500 

LDECONFIG=/usr/lib/lde/lde.$TERM.cfg 

export uP TERM LDECONFIG 

sel $uP 

alOOffff 

reset 

payment.cmd - compile, ics, link, and pdb run command file 

set -V 

: z8002 payment.ps demo run 

: assume setup run already 

pas -dvslo payment.po payment.ps >payment.pl 

ics -olv payment.is 

link -d -o payment.lo -c payment.ic 

pdb -v payment.lo 

payment.is - ics source file 

PASCAL.CONFIGURATION payment pdb test 

HARIAVARE.CONFIGURATION Z8002 

EXECUTION_M0DE SYSTEM, SYMBOL I C.DEBUG 

EMJLATOR_ADDRESS_ SPACES SEPARATE 

INSTRUCtToNS.RC^ [00012H,0003FH] , (00060H,07FFFH) 

CONSTANTS_RCM ( 08000H, 08FFFH] 

GLOBAL.VAR.RAM ( 08 00 OH, ODTFFH] 

HEAP_STACK_RAM ( 0D800H, OFFFFH] 

RESET_MEM)RY YES 

DYNAMIC.RAM NONE 

SERVICE. CALLS 40H,0FFF0H 

SOFTWARE.CONFIGURATION /us r/gregs/Pascal /Z8002/Paymen t/paymcnt . po 

MODULE NONE 

LIBRARY NONE 

FLOAT I NG_PO I NT_ SUPPORT YES 

FILE. SUPPORT DEFAULT 

ERROR.HANDLING DEFAULT 

INTERRUPT.CONFIGURATION UNIMPL_INSTR_TRAP, SYSTENLCALL.TRAP 
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FAULT.NOT I F I CAT I ON PASCAL.RTS 
RESTART.LABEL PASCAL_BEGIN 

END 

payment. ic - linker command file 

-0 payment. io 

-m INSTRQQ.ROM-04000012H-0400003FH 04000060H-04007FFFH 

-m CONSTQQ.ROM— 01008000H.01008FFFH 

-m SRBVQQ.RAM-01000040H-0100005FH 

-m DATAQQ.RAM=01009000H-0100D7FFH 

-mZZRESETVQQ.ROM»=04000002H-04000005H 

-L class-=INSTRQQ range INSTRQQ.ROM 

-L class-CONSTQQ range CONSTQQ.ROM 

-L class=SRBVQQ range SRBVQQ.RAM 

-L class=DATAQQ range DATAQQ.RAM 

-L class-=ZZRESETVQQ range ZZRESETVQQ.ROM 

-D HEAPBASEQQ-0100D800H 

-D STKBASEQQ=0100FFFFH 

-D SVCLOCZZ-OFFFOH 

-0 /usr/gregs/Pascal/Z8002/Payment/payment.po 

-0 /lib/z8000/pas.conv.nseg 

-0 /lib/z8000/pas.hiio.nseg 

-0 /Iib/z8000/pas.fpsimr4.nseg 

-0 /lib/z8000/pas.rts.nseg 

-0 /lib/z8000/pas.err.nseg 

-O /lib/z8000/pas.rts.nseg 

-0 /lib/z8000/pas.err.nseg 

-0 /lib/z8000/pas.posi.nseg 

-0 /lib/z8000/pas.conv.nseg 

-X PASCAL_BEGIN 

payment.log - program execution log 

start log: Sat Jul 9 16:68:57 PDT 1983 

# load " paymen t . 1 o" 

# go 

Enter loan_amount i n te r e s t_r ate and numbe r_o f_paymen t s 
500.0 16.0 12 

Paymen t 

45. 13 
45. 13 
45. 13 
45. 13 
45. 13 
45. 13 
45. 13 
45. 13 
45. 13 
45.13 
45.13 
45.13 
0.00 



Payme 


nt # 


Pr 


i n c i pa 1 


Pay 


me n t on 


Interest 


Ac cumu 1 a ted 










Pr 


i n c i pa 1 








In 


t e r e s t 




1 




461 . 12 




38.88 




6.25 






6.25 




2 




421.76 




39.36 




5.76 






12.01 




3 




381 .90 




39.86 




5.27 






17.29 




4 




341.54 




40.36 




4.77 






22.06 




5 




300.68 




40.86 




4.27 






26.33 




6 




259.31 




41.37 




3.76 






30.09 




7 




217.43 




41.89 




3.24 






33.33 




8 




175.01 




42.41 




2.72 






36.05 




9 




132.07 




42.94 




2. 19 






38.23 




10 




88.60 




43.48 




1.65 






39.89 




11 




44.57 




44.02 




1.11 






40.99 




12 




0.00 




44.57 




0.56 






41.55 




13 




0.00 




0.00 




0.00 






41.55 


Program 


te rmi na 


ite 


d 
















# break 


payment 


#25 after 


12 














# break 






















Name Usage Kir 


td 


Ad d r e s s 
















SWl: Used X 




PAYMENT#25 


SC:0013BA 




aft 


e r 


12 


26 
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HWl: Free 
HW2: Free 
TTAl: Free 
TTA2: Free 
TTA3: Free 
nA4: Free 
# reset 


R/W 
R/W 
R/W 
R/W 
R/W 
R/W 


















# go 

En t e r 1 oan 

500.0 15.0 


_anioun 
'l2 


t interest 


_r a 


te and n 


umb 


e r_o f_payment s 






Payment 


# P 


r i nc i pal 


Payment on 




Interest 


Accumu 1 ated 


Paymen t 




1 


461. 12 


Principal 
38.88 




6.25 


Interest 
6.26 


45. 


13 




2 


421.76 




39.36 




5.76 


12.01 


45 


13 




3 
4 


381.90 
341.54 




39.86 
40.36 




5.27 

4.77 


17.29 
22.06 


45. 
45 


13 
13 




6 


300.68 




40.86 




4.27 


26.33 


45. 


13 




6 


259.31 




41.37 




3.76 


30.09 


46 


13 




7 


217.43 




41.89 




3.24 


33.33 


45. 


13 




8 


175.01 




42.41 




2.72 


36.05 


46. 


13 




9 
10 


132.07 
88.60 




42.94 
43.48 




2. 19 
1.65 


38.23 
39.89 


46 

46. 


13 
13 




11 


44.57 




44.02 




1.11 


40.99 


46. 


13 


SWl: Used 


12 
X 


0.00 
PA\MENT#25 


44.57Brea 
SC:0013BA 


kpoint En 


coun te r ed : 






^ p r i n c i pa 
PRINCIPAL = 


1 

= 1 .991271E-03 
















# exit 
MDP Pascal 


Z8000 


debug exi 


t i n 


e 













68000 

These listings contain a working set of files to run the 68000 payment.ps pdb learning guide demo. Note that a 
new -.is and -.ic file are used to enable pdb to run correctly. To run the demo, invoke the file setup by: . setup 
<cr> to initialize. Next run the command file payment.cmd to compile, ics, link, and pdb the program. The file 
payment.log shows the working output of the pdb execution. 

Notes: 

The recommended configuration is terminal-8540-8560. If using the 8540 remotely, a terminal is still required on 
the 8540 to run this program. 

The 68000 library requires entering a decimal point for real number input, so 500.0 15.0 12 must be entered 
instead of 500 15 12 as the manual shows. 

The modified /lib/68000/default.is which must be used is called payment.is for ics and payment.ic for the linkage. 
See the payment.cmd file for proper invocation of the compiler, ics, link, and pdb. 

68K pdb can run with an 8550 or 8540 in term mode to the 8560. 

setup - initialization command file, modify as required 

: 68000 pascal setup command file 

: execute this by: ' . setup <cr> ' 

LDECONFIG=/usr/lib/lde/lde.ct8500.cfg 

TERM=ct8600 

uP=68000 

export uP TERM LDECONFIG 

sel $uP 
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payment.cmd - compile, ics, link, and run command file 

set -V 

: payment.cmd - 68000 learning guide demo run 

: assume setup run already 

: run compilation... 

pas -dvslo payment. po payment.ps >payment.pl 

: run ics... 

ics -Iv payment. is 

: perform link... 

link -d -0 payment. lo -c payment.ic 

: run pdb via payment. ie 

payment.ic 



payment. is - ics source file 

PAS CAL _CONF I CURAT I ON 

HARr^\ARE_CONF I CURAT I ON 

PRIVILECE.STATE 

EMJLATOR.ADDRES S_SPACES 

INSTRUCT I ONS_RCM 

CONSTANTS.ROVi 

GLOBAL_VAR_RAM 

HE.AP_STACK_RAM 

RESET_MEM)RY 

SERVICE.CALLS 

SOFTWARE^CONF I CURAT I ON 

MODULE 

LIBRARY 

FLOAT I NC^PO I NT^SUPPORT 

FILE.SUPPORT 

ERROR_R\NDLING 

I NTERRUPT.CONF 1 CURAT I ON 

I NTERRUPT.PROCEDURE 

FAULT.NOT I F I CAT I ON 

I N I T I AL I Z AT I ON.CODE 

END 



payment - pdb learning guide demo 

68000 

SUPERVI SOR , PASCAL_DEBUC 

CONTIGUOUS 

00400H-07FFFH 

08000H-08FFFH 

09000H-0D7FFH 

0D800H-0FFCFH 

YES 

0FFD0H,0FFF0H 

/us r/g r eg s /Pascal / 68 00 /Payme n t /payment . po 

NONE 

NONE 

PASCAL _RTS 

PASCAL_RTS 

PASCAL.RTS 

ROM , H I GHEST_VECT0R=4 7 

NONE 

PASCAL.RTS , STOP 

PASCAL.BEGIN 



payment.ic - linker conniand file 

-d 

-0 payment . i o 

- o payme n t . 1 o 

-0 /usr/gregs/Pascal / 6 800 /Payme n t /payment 

-0 /I ib/68000/pas . conv 

-0 /I ib/68000/pas . hi io 

-0 /I ib/68000/pas . fpsimr4 

-0 /I ib/68000/pas . r ts 

-0 /I ib/68000/pas. err 

-0 /I ib/68000/pas. rts 

-0 /I ib/68000/pas .err 

-0 /I ib/68000/pas . pos i 

-m RESETVQQ.Rav4-08000000H-08000007H 

-m VECTRQQ.ROM-04000008H-040000BFH 

-m INSTRQQ.R(M-08000 400H-08007FFFH 

-m CONSTQQ.R(^M)4008000H-04008FFFH 

-m DATAQQ.RAM»0 4009000H-0400D7FFH 

-m SRBVQQ.RA\i=0400FFDOH-0400FFEFH 

-L c 1 a s s=RESETVQQ range RESETVQQ.ROM 

-L c I a s s=\^CTRQQ range VECTRQQ.ROM 
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-L class=INSTRQQ range INSTRQQ.RCM 

-L class==CONSTQQ range CONSTQQ.ROM 

-L class=OATAQQ range DATAQQ.RAM 

-L class=SRBVQQ range SRBVQQ.RAM 

-D HEAPBASEQQ=04 00D800H 

-D STKBASEQQ=04 00FFCCH 

-D SVCLOCZZ=04 00FFF0H 

-X PASCAL_BEGIN 



payment. ie - enulator setup and download comnand file 

cat « e o f 

Preparing emulator and downloading... 
eo f 

set - X 
sel 68000 

if test $? 1=0; then exit 1; fi 
s s r=2 700 

if test $? != 0; then exit 1; fi 
a - a 

if test $? !-= 0; then exit 1; fi 
SVC on, OFFDOH, OFFFOH 

if test $? !— 0; then exit 1; fi 
if al >$$; then 

al OOH OFFFFH 

if test $? != 0; then exit 1; fi 
f i 

rm - f $$ 

rm - f /tmp/8540$IU 
s ssp=:0FFCCH 

if test $? !=0;then exit 1; fi 
pdb paymen t . 1 o 



payment.log - program execution log 



start 1 


og: Sun 


Jul 10 12: 


45 


:34 


PDT 1983 


















# load 


' paymen 


t. lo" 


























# go 






























Enter 1 


3an_amount interes 


t_ 


rat 


e and n 


umb 


e r_ 


of. 


_paymen 


t s 








500.0 15.0 12 




























Payment # 


Principal 


P 


ayment on 




Int 


e r e s t 


Ac cumu 1 ated 


Payment 










Principal 












In 


t e r e s t 








1 


461. 12 






38.88 






6 


25 






6.25 


45 


13 




2 


421.76 






39.36 






5 


7 6 






12.01 


46 


13 




3 


381.90 






39.86 






5 


27 






17.29 


45 


13 




4 


341.54 






40.36 






4 


77 






22.06 


45 


13 




5 


300.68 






40.86 






4 


27 






26.33 


45 


13 




6 


259.31 






41.37 






3 


76 






30.09 


45 


13 




7 


217.43 






41.89 






3 


24 






33.33 


45 


13 




8 


175.01 






42.41 






2 


72 






36.05 


45 


13 




S 


132.07 






42.94 






2 


19 






38.23 


45 


13 




10 


88.60 






43.48 






1 


65 






39.89 


45 


13 




11 


44.57 






44.02 






1 


11 






40.99 


45 


13 




12 


0.00 






44.57 









56 






41.55 


45 


13 




13 


0.00 






0.00 









00 






41.55 


0. 


00 


P r g r am 


t e rmi na t ed 


























# reset 






























# break 


paymen 


t#25 after 


12 
























# break 
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Name 


Usage Kind 


Ad d r e s s 






SWl 


Used X 


PA\TV1ENT#25 


SP:001D86 after 12 




HWl 


Free R/W 








HVV2 


Free R/W 








HVV3 


Free R/W 








TTAl 


Free R/W 








TTA2 


Free R/W 








riAS 


Free R/W 








TTA4 


Free R/W 








# go 








Enter loan_amount 


i n te re s t_r ate and numbe r_o f_payment s 




500.0 15.0 12 








Payment # Pr 


i nc i pa 1 Pay 


ment on Interest Accumula 


ted 




Pr 


incipal Interest 


1 


461 . 12 


38.88 6.26 6 


25 


2 


421 .76 


39.36 5.76 12 


01 


3 


381 .90 


39.86 5.27 17 


29 


4 


341 .54 


40.36 4.77 22 


06 


5 


300.68 


40.86 4.27 26 


33 


6 


259.31 


41.37 3.76 30 


09 


7 


217.43 


41.89 3.24 33 


33 


8 


175.01 


42.41 2.72 36 


05 


9 


132.07 


42.94 2.19 38 


23 


10 


88.60 


43.48 1.65 39 


89 


11 


44.57 


44.02 1.11 40 


99 


12 


0.00 


44 . 57Breakpo i n t Encounterec 


1: 


SWl: Used X 


PA\MENT#25 


SP:001D86 




# principal 








PRINCIPAL = 1.99 1271E-03 






# tb 








$0: PAYMENT 


SP:001D86 


at statement number 25 




# type payment 








program (statemen 


ts 2 . . 25) 






V ar 








INPUT: TEXT 








OUTPUT: TEXT 








PRINCIPAL: REAL 






INTRATE: REAL 








PAYONPRIN: REAL 






PA^'MENT: REAL 








INTEREST: REAL 






ACCIMINT: REAL 






NPAY: INTEGER 








PA^^NUM: INTEGER 






procedures 








PCA\ER: functi 


on returning 


REAL (statement 1) 




# e 


X 


i t 









Paymen t 

45. 13 
45. 13 
45. 13 
45. 13 
45. 13 
45. 13 
45. 13 
45. 13 
45. 13 
45. 13 
45. 13 



8086 

These listings contain a working set of files to run the 8086 payment.ps pdb learning guide demo. Note that a 
new -.is and -.ic file are used to enable pdb to run correctly. To run the demo, invoke the file setup by: . setup 
<cr> to initialize. Next run the command file payment.cmd to compile, ics, link, and pdb the program. The file 
payment.log shows the working output of the pdb execution. 
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Notes: 

The recommended configuration is terminaI-8540-8560. If using the 8540 remotely, a terminal is still required on 
the 8540 to run this program. 

8086 pdb will also work with an 8550 in term mode to the 8560 when the next version is released. 

The modified /lib/8086/default.is which must be used is called paymcnt.is for ics and payment. ic for the linkage. 
See the payment.cmd file for proper invocation of the compiler, ics, link, and pdb. 

setup • initialization command file, modify as required 

: execute this by: ' . setup <cr> ' 

LDECONFIG=/usr/lib/lde/lde.ct8500.cfg 

TERM«ct8500 

uP=8086 

export uP TERM LDECONFIG 

sel $uP 

alOOffff 

payment.cmd - compile, ics, link, and pdb command file 

: assume IU,uP setup 

set -V 

pas -dvslo payment.po payment.ps >payment.pl 

ics -olv payment.is 

link -d -o payment. lo -c payment.ic 

pdb payment. lo 

payment.is - ics source file 

PASCAL.CONFIGURATION Default Configuration 

HAREWARE.CONFIGURATION 8086 

INSTRUCT I ONS_R(M (00060H, 07FFFH] 

CONSTANTS.RCM [08000H, 08FFFH] 

GLOBAL _VAR_RAM JOSOOOH, 0D7FFHJ 

HEAP_STAa<:_RAM 1 0D800H, OFFFFH) 

RESET31EM)RY NO 

SERVICE.CALLS DEFAULT 

SOFTWARE_CONFIGURATION /us r /gregs/Pascal /8086/Paymen t/paymen t . po 

MODULE NONE 

LIBRARY NONE 

F I LE_ SUPPORT DEFAULT 

INTERRUPT.CONFIGURATION NONE 

RESTART.LABEL PASCAL.BEGIN 

END 

payment.ic - linker command file 

-0 payment.io 

-D STKBASEQQ=OFFFFH 

-D HEAPBASEQQ=0D800H 

-D SVCLOCZZ=0FFF0H 

-m INSTRQQ.ROM=060H-07FFFH 

-m CONSTQQ.ROM=08000H-08FFFH 

-m DATAQQ.RAM-:09000H-0D7FFH 

-m SRBVQQ.RAM-040H-05FH 

-L class-=INSTRQQ range INSTRQQ.ROM 

-L class-CONSTQQ range CONSTQQ.ROM 

-L class=DATAQQ range DATAQQ.RAM 

-L class-=SRBVQQ range SRBVQQ.RAM 
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-0 /usr/gregs/Pasca!/8086/Payment/payment.po 

-D CODEBASEQQ-060H 

-D DATABASEQQ-08000H 

-0 /lib/8086/pas.hiio.scsd 

-0 /lib/8086/pas.fp86.scsd 

-0 /lib/8086/pas.rts.scsd 

-0 /lib/8086/pas.err.8csd 

-0 /lib/8086/pas.posi.scsd 

-0 /lib/8086/pas.conv.scsd 

-X PASCAL.BEGIN 



payment. log - program 


execution 


log 














start log: Wed Ju 


1 20 16: 


44:55 PDT 1983 














# 1 oad " payment . 1 < 


3" 
















# «o 


















Enter loan_amount 


i nte res t_rate and numb 


er 


_of_payme 


nts 






500 15 12 


















Payment # Principal 


Payment on 


Interest 


Ac cumu 1 ated 


Payment 






Principal 








In 


te r es t 




1 


461. 12 


38.88 




6.25 






6.25 


45.13 


2 


421.76 


39.36 




5.76 






12.01 


45. 13 


3 


381.90 


39.86 




5.27 






17.29 


45. 13 


4 


341.54 


40.36 




4.77 






22.06 


45. 13 


5 


300.68 


40.86 




4.27 






26.33 


45.13 


6 


259.31 


41.37 




3.76 






30.09 


45.13 


7 


217.43 


41.89 




3.24 






33.33 


45.13 


8 


175.01 


42.41 




2.72 






36.05 


45. 13 


9 


132.07 


42.94 




2. 19 






38.23 


45. 13 


10 


88.60 


43.48 




1.65 






39.89 


45.13 


11 


44.57 


44.02 




1.11 






40.99 


45. 13 


12 


0.00 


44.57 




0.56 






41.55 


45. 13 


13 


0.00 


0.00 




0.00 






41.55 


0.00 


Program terminated 
















# reset 


















# break payment#26 after 


12 














# break 


















Name Usage Kind 


Ad d r e s s 
















SWl 


Used X 


PAVMENT#25 521 




after 12 








»V1 


Free R/W 


















HW2 


Free R/W 


















»V3 


Free R/W 


















# go 


















Enter loan_amount 


interest_rate and numb 


er 


_of_pay 


ment s 






500 15 12 


















Payment # Pr 


i nc i pal 


Payment on 
Pr inc i pal 


In 


terc s t 


Ac 


c umu 1 a t e d 
Interest 


Payment 


1 


461. 12 


38.88 




6.25 






6.25 


45. 13 


2 


421.76 


39.36 




5.76 






12.01 


45. 13 


3 


381.90 


39.86 




5.27 






17.29 


45. 13 


4 


341.54 


40.36 




4.77 






22.06 


45. 13 


5 


300.68 


40.86 




4.27 






26.33 


45.13 


6 


259.31 


41.37 




3.76 






30.09 


45.13 


7 


217.43 


41.89 




3.24 






33.33 


45.13 


8 


175.01 


42.41 




2.72 






36.05 


45.13 


9 


132.07 


42.94 




2.19 






38.23 


45.13 


10 


88.60 


43.48 




1.65 






39.89 


45.13 


11 


44.57 


44.02 




1.11 






40.99 


45.13 


12 


0.00 


44.57Brea 


kp 


o i n t En 


icount 


e r ed : 
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SWl: Used X PAYMENT#25 521 

# principal 
PRINCIPAL - 1.991271E-03 

# type payment 

program (statements 2 .. 25) 
var 

INPUT: TEXT 

OUTPUT: TEXT 

PRINCIPAL: REAL 

INTRATE: REAL 

PAYONPRIN: REAL 

PAYMENT: REAL 

INTEREST: REAL 

ACCIMINT: REAL 

NPAY: INTEGER 

PAYNIM: INTEGER 
procedures 

PCMER: function returning REAL (statement 1) 

# tb var 

$0: PAYMENT 521 at statement number 25 
Local variable(s): 

INPUT = {file value not displayed} 

OUTPUT = {file value not displayed} 

PRINCIPAL = 1.091271E-03 

INTRATE = 1.500000E+01 

PAYONPRIN -= 4.457182E+01 

PAYMENT = 4.512900E>f01 

INTEREST » 5.571727E-01 

ACCIMINT — 4. 155000E+01 

NPAY «= 1 2 

PAYNIM - 12 

# exi t 

Greg Saville MDP Technical Support Manager 



PASCAL DEBUG/TERMINAL CONNECTION 

Pascal Debug requires I/O to/from the console, the best configuration is to connect the terminal to the 8540 or 
8550 which is connected to the 8560. If the terminal is to be connected to the 8560, another terminal (null con- 
nector) must be connected to the console port on the 8540. 

Marilyn Hanson MDP Product Marketing Manager 



September 1983 TEKTRONIX 33 



MDP APPLICATIONS Issue 2 - Vol 2 USER GROUP NEWS 



ACE V.3 & ACECONFIG 

ACE Version 3 is supplied with new configuration files for the CT8500 and 4105 terminals. These new -,cfg files 
MUST be used with the new version of ACE. This also means that any user created -.cfg files must be rebuilt 
with the new aceconfig to be compatible. Suggestion: Before updating to version 3, print a copy of your existing 
config file (aceconfig -v /usr/lib/ace/< terminal >. cfg | Iplr) to use as an input list when creating the new 
configuration file. 

Greg Saville MDP Technical Support Manager 



Z8000 MEMORY ALTERATION PROBLEMS 

The Z8000 emulator exhibits some unexpected symptoms under the following conditions: 

1. EM 1 with memory mapped to user, or EM 2 . 

2. do a download to user (loading a program for example) or a "fill" of user memory or any other memory 
alteration. 

3. press any key on the keyboard at the same time (generating an interrupt to the 2650). 

The "unexpected symptom" could be either a memory error message or possibly a complete system lockup which 
requires re-booting. 

Here is a solution. Lift pin #14 on U 4150 on the emulator and connect a wire from it to ground. This mod is 
unofficial at this point and all the usual cautions apply. 

Wolfgang Takatsch MDP Technical Support 



CONSTANTS LOCATION WITH 8088 PASCAL - CORRECTION 

The program example which appeared in User Group News, Issue 1, Volume 2, page 41, was in error. The 
corrected listing is as follows: 

SECTION CNST_CPY_SEC,CLASS=INSTRQQ 

GLOBAL CNST_CPY,PASCAL_BEGIN,CODEBASEQQ 

CNST.CPY XORW SI.SI ; CLEAR THE SI REGISTER 

MO\'W AX,#OAOOH ; LOCATION OF NEW ROM / 16 
MOVW DS,AX 

MOVW DI,SI ; CLEAR THE DI REGISTER 

MOVW AX,#OFOOH ; DESTINATION OF CONSTANTS.ROM / 16 
MOVW ES.AX 

MOVW CX,#01000H ; SIZE OF CONSTANTS_ROM (OFFFFH-0 
CLD 

REPZ MOVE ; BLOCK TRANSFER 
JMPS PASCAL_BEG1N,C0DEBASEQQ ; TRANSFER TO ICS INITIALIZATION 
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MDP USER GROUP SOFTWARE LIBRARY/ARTICLE SUBMITTAL FORM 

The following form may be used to submit software which you feel might be of interest to other MDP users. 



Entries should be forwarded to: 

Library Manager 
Tektronix, Inc. 
Del. Sta. 92-635 
P. O. Box 4600 
Beaverton, Oregon 97075 
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MDP USER'S GROUP SOFTWARE LIBRARY/ ARTICLE SUBMITTAL FORM 

1. ABSTRACT. ^ 



2. Execution CPU Primary Language. 

Hardware configuration required 



Software configuration required (include source if non-Tek) 



3. Do you want the following to appear in U.G.N. 

Author's name yes no 

Company Name yes no 

Area code Tel. No. yes no 



Company address. 



4. Program Title. 



Program Function 



5. Source. If insufiicient room is provided, please submit a disk (containing the information requested) attached to 
this form. 



6, 1 am submitting the program/article described above for possible placement in the MDP User's Group Library. 
I understand there is no further compensation due to me. This program/article is of my own design, the data 
contained in this submittal is not copyrighted and does not break any obligation to another person or organiza- 
tion relating to proprietary or confidential information. Tektronix, Inc. is authorized to distribute or publish 
copies of this program. 

Signature Date 
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PLM COMPILERS - 100% INTEL-COMPATIBLE - ON THE 8560. 

SEE LANGUAGE SOFTWARE. 

MDP SOFTWARE REFERRAL SERVICE 

INTRODUCTION AND BENEFITS 

Tektronix offers you a Referral Service for software products from independent vendors. Published here is infor- 
mation about these vendors and products. Customers locate products using this information and obtain the pro- 
duct from the software vendor. 

Benefits to Tektronix customers of this service are: . 

• Our commitment to increase the value of your MDP systems 

• Access to many software vendors for MDP related products 

• Promotes independent development of MDP related products 

• Quickly find current information on third party software for MDP systems 

• Many useful products to enhance your MDP system 

Tektronix' Microcomputer Development Products meet your micro development needs. 

TEKTRONIX REFERRAL POSITION 

Tektronix acts only as a referral source for these products and vendors. Tektronix does not necessarily evaluate, 
analyze, or approve of these products. Referral does not imply fitness for a particular purpose and it is not a 
recommendation to buy. Evaluation, purchase, and support of these products are between the customer and the 
vendor. Although Tektronix believes this information is accurate, we do not guarantee it's accuracy. Tektronix 
suggests it's customers obtain current product information and assess compatibility with MDP products before 
purchase. 
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PRODUCT INFORMATION OFFERED 

Product information is presented in tables following this introduction: * 

Trademarks Vendors' trademarks referenced here 

Language Software Cross-Reference Select language & micro, find vendor 

Software Products for 8550 &, 8002A Products running on the 8550 or 8002A 

Language Software for the 8560 Products running on 8560s and others by that vendor 

Language Software for DEC Minis Products for Host-based software development 

Real-Time Operating System Kernels With some compatibility with MDP systems 

UNDC Software Vendors For applications other than lanuages 

RT-11 Software Vendors Products that may run on 8550 with RTll/50 

UNIX Services Other UNIX software information sources 

Vendor Contact Information US Vendors of MDP-related language products 

International Distributors For the US vendors in previous table 

The principal source of information for these referrals is vendors' product literature. Tektronix updates this infor- 
mation regularly. Any prices shown are approximate; contact vendor for current prices. 

PRODUCT LISTING CRITERIA 

Inclusion of a software product or vendor in these tables means it has met these criteria: 

1. The product is useable on or with Tektronix development systems, or the vendor markets for other comput- 
ers products that may, without change, operate on Tektronix development systems. 

2. The product is useful for microcomputer application development, or the product serves an application for 
which MDP customers may want to use their system. 

3. The product is available unbundled and product information is available from the vendor. 

Neither price nor vendor is a criteria. 

PRODUCT COMPATIBILITY 

Compatibility of these products with MDP systems varies. Factors to consider are distribution media, executabil- 
ity, download formats/routines, interface to MDP debugging tools, and other software interfaces. Some tables 
indicate the compatibility Tektronix believes exists. Customers can assess compatibility by a demonstration, 
evaluation version, return policy, contacting other users, etc. 

USING THE LISTS 

Locating Products. To find vendors of a particular language for a particular micro, consult the Cross Reference 
table, then see the product tables for more information about the product. See Vendor Contact Information or 
International Distributors to learn how to contact the vendor. 

Obtaining Products. Locate alternative products using these lists. Obtain further information from the vendor, 
other users, and your Tektronix sales engineer. Choose desired product and arrange purchase and support with 
software vendor. 

GETTING MORE INFORMATION 

Contact the vendor or distributor for more information about their product. Some customers who have used 
third party software with MDP systems offer an appraisal oT that software. Your Tektronix sales engineer may 
have such customer references. Sources in the UNDC Services table offer additional information about UNIX 
software. 



• This iMue of U*er Gioup News oontiins on^ changes to the tables; for the complete Using see User Group News Issue 1 • Volome 2. 
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USER AND VENDOR FEEDBACK 

Tektronix solicits from software vendors information about new products and corrections or additions to the infor- 
mation presented here. Tektronix solicits from it's customers information about a purchased product's compati- 
bility, quality, value, etc. Tektronix also seeks customers who are willing to be a reference for such information to 
other customers. If customers develop MDL-related software products, they may wish to have it listed herein. 
Send any of this information to 

Tektronix, Inc. 
MDP Third Party Software 
Walker Road Industrial Park 
P.O. Box 4600, M.S. 82-635 
Beaverton OR 97075 



MDP SOFTWARE REFERRAL CATALOG UPDATE 

This issue of User Group News contains changes and additions to the Catalog published in User Group News 
Number 2 (June 83). 

CHANGES TO MDP SW REFERRAL CATALOG 

Systems & Software, Inc. Moved 

SSI's new location (effective 22 Aug 83): 3303 Harbor Blvd., Casta Mesa CA 92626, Ph: 714-241-8650. 

Telecon Moved 

Telecon is now located at 1155 Meridian, Suite 218, San Jose CA 95125. 

IPI Distributors Changed 

Industrial Programming Inc. offers Multi-Tasking Operating Systems (see Catalog Additions below). There are 
several changes in their international distributors; all of them are listed here: 

Country Distributor 



France Celdis SA 

53 Rue Charles Frerot 
04250 Gentilly 
ph: (1) 546.13.13 

Metrologie 
La Tour d'Asnieres 
4 av. Laurent Cely 
92606 Asnieres Cedex 
ph: 791.44.44 



Germany Scientific Control Systems GmbH 

Postfach 62 04 80 
Oehleckerring 40 
2000 Hamburg 62 
Ph: 040 531030 
Tx: 841-2174113 

Celdis-Enatechnik-System Vertriebsgesellschaft GmbH 

Schillerstrasse 14 

2085 Quickborn (Hamburg) 

Ph: 041 06/61^240 

Tx: 841-213590 
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Country Distributor 



India Saras Electronics 

21 Perambur Barracks Road 
Madras 600012 
Ph: 32497 



Israel R. N. Electronics Agencies Ltd. 

15 Kineret Street Bney-Brak 
P. 0. Box 10205 
Tel-Aviv 61 101 
Ph: (03) 79 69 27 
Tx: 922-3472107 



Japan Tokyo Electron Limited (MTOS-86, 80, 80MP) 

Shinjuku Nomura Bldg 
1-26-2 Nishi-Shinjuku 
Shinijuku-Ku 
Tokyo 160 
Ph: (03) 344-5893 

C. Itoh Data Systems Limited (\fT0S-68K, 68KF, 68, 69) 
C. Itoh Bldg. 
2-5-1 Kita-Aoyama 
Minato-Ku 
Tokyo 107 
Ph: (03) 497-8096 

Scandanavia Frontec Microdatorcentrum AB 

Box 204 

Malm V age n 28 

Sollentuna, Sweden 

Ph: 08-359360 

Tx: 854-15130 

Switzerland Xmit AG 

Bellikonerstrasse 218 

CH-8967 Widen 

Ph: 057-54656 

Tx: 845-59955 

U.K. Itech 

Bessemer Road 

Stevenage 

Herts SGI 2DX 

Ph: (04380) 66561 
Tx: 851-825824 

NEW PRODUCTS FOR MDP SW REFERRAL CATALOG 

There is information about languages, operating systems, and applications. Contact the vendor for product specs, 
prices, and references. Advise the vendor that you're interested in product compatibility with Tektronix' Micro- 
computer Development Products. 

PLM on 8560 

Caine, Farber, and Gordon (213-449-3070 California) is field testing on the 8560 PLM compilers for the 8080 and 
8086. The compilers are 100% Intel compatible and produce Tektronix Linker object module format. The 8080 
PLM is also available with Intel-compatible assembler/linker. The compilers will be available as products in the 
near future. Contact the vendor if you are interested in references or being a test site. 
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8086 Pascal, FORTRAN, & Assembly 

First Systems Corp. (213-546-5581 California) offers Pascal and FORTRAN for the 8086 on VAX and IBM hosts. 
They offer for an Intel-compatible assembler/linker/locator for the 8088 on VAX. They also offer a sophisticated 
symbolic debugger that can be used with both their and Intel's products. 

C 6800 on 8560 

Introl Corp (414-276-2937 Wisconsin) offers a C 6809 cross-compiler on PDP-11 UNIX and 8560 systems. It sells 
for $1500; specify 8560 media when ordering. The compiler is said to accept Kernighan & Ritchie C (the Bell Labs 
standard) and generate very high quality code. The product comes with a 6809 assembler. See SOFTWARE 
PRODUCT REFERENCES. 

JMI Software (215-657-5660 Pennslyvania) distributes in the US the C 6809 compiler from Real Time Systems for 
$1550. It runs on DEC minis and the 8560. The 8560 version generates assembly compatible with Tek's 6809 
assembler. Real Time Systems (phone: 0624-833403, telex:628356 TOMASS; England) offers this compiler in 
Europe. See SOFTWARE PRODUCT REFERENCES. 

C 16032 

JMI Software Consultants (215-657-5660) offers a C 16032 compiler on VAX (VMS and UNIX) for $1500. The 
16032 assembler/linker package is available separately for $500. 

BASTOC 

JMI Software Consultants (215-657-5660) offers a Basic to C Translator for any system that supports C. It sup- 
ports ANSI 78 BASIC with most Microsoft and some CBASIC extensions. BASTOC can be tailored to BASIC 
dialects, possibly including Tek's 8550 MDL/u. 

Jovial 

Proprietary Software Systems (429 Santa Monica Blvd., Suite 430, Santa Monica CA 90401, Ph: 213-394-5233) 
offers Jovial compilers for 1750A, 8086, and z8000 on VAX and IBM systems. Assembler, linker, and simulator 
are also available with these products. PSS also offers a complete line of full-function assemblers for most micros 
and running on many hosts. 

Ada 

Telesoft (619-457-2700 California) offers Telesoft-Ada compilers and other Ada related products. A cross-compiler 
for the 68000 is available on VAX (VMS and UNIX 4.1bsd) and IBM 370. 

Irvine Computer Sciences Corp (714-764-6684 California) offers an Ada to C translator and is working on machine 
code generators. Their products arc available only from distributors today. Contact the vendor for a list of dis- 
tributors. 

8-bit C on 8560 

Holos Corp (404-373-0110, Georgia) offers C compilers for 8080, 8085, 28O, and 6809. Support for others is avail- 
able upon request. The compilers run on the 8560 and generate Tek assembly code. Price is $1200; specify 8560 
media when ordering. 

8-bit C and Pascal on 8560 

Real Time Systems (phone: 063^-73,3131, telex: 53429 PACE G; England) offers both C and Pascal compilers for 
8080, z80, 6502, 8086, 68000, and 6809. The compilers run on DEC minicomputers and the 8560. 8560 versions 
for 8080, z80, and 6809 produce Tek Assembly language. RTS is seeking 8560 test sites for the 8080 and z80 ver- 
sions. RTS also offers cross-assemblers for most micros on DEC minis and UNIX systems. 

8-bit Pascal on VAX and PDP-11 

Boston Systems Office (617-894-7800) now offers Pascal Z80 and 6809 on VAX/VMS and PDP-11/RSX. BSO 
already offers Pascal support for the 68000, 8086/186. For compatibility with Tektronix' 8540 Integration Sys- 
tem, BSO offers download and Extended TEKHEX support. 
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68000 FORTRAN, C, & PL/M 

Green Hills Software (213-796-6543 California) offers FORTRAN, C and PL/M for the 68000 on a VAX/UNIX. 
They cost $6000; compilers for VMS are available by special request. Output is either UNIX or Motorola format. 

C8086 + Debug 

C Systems (714-637-5362 California) offers a C compiler for the 8086 with a sophisticated symbolic debug capabil- 
ity. The product is available now on IBM PC. 

TMS 320 Assembler 

PH Associates (703-281-5762, Virginia) offers an assembler for the TMS 320. It runs on the 8560, PDP-11, and 
CP/M systems. It is very fast and supports TEKHEX (not relocatable). The price is $1000. TMS 320 from 
Texas Instruments is high speed single-chip microcomputer for signal processing applications. 

REAL TIME OPERATING SYSTEMS 

MTOS 88000 

Industrial Programming Institute (516-036-6600 New York) now offers their MTOS 68000 in Tek Assembly source 
for full compatibility with Tektronix' development tools for the 68000. MTOS is a multi-tasking real-time operat- 
ing system with support for memory management and multi-processors. There are also options for a file system 
and floppy disk driver. 

VRTX z80 

Hunter & Ready (415-326-2950 California) now offer VRTX for the z80. VRTX is already available for 68000, 
8086, and z8000. VRTX is provided in a loadable form that is used with Tektronix development tools with minor 
adaptation: program Tek assembly routines to match the parameter calling conventions of 8560 Pascal with each 
VRTX function (about 15). Hunter & Ready also now offers TRACER, a debugging tool for VTRX-based sys- 
tems, for the 68000 (8086 to follow). 

REX Tools 

Systems & Software (714-241-8650 California) offers REX Tools for the 8086/88. REX Tools include a Pascal 
compiler, Intel-compatible assembler/linker/locator, operating system kernel, and an interactive symbolic software 
emulator called Softprobe. 

C Executive 

JMI Software (215-657-5600) now offers their C Executive for the NS16032. C Executive is also available for LSI- 
11, MC68000, 8080/85, 8086/88, and Z80. 

pSOS 68000 

Software Components Group (408-923-2741 California) offers a real-time multiprogramming, multitasking, operat- 
ing system kernel for the 68000. pSOS is provided in loadable, object form that can be used with 8500 products. 
There is a companion file system FILES-68K. 

RTOS-80 

Microsystems, Inc. (213-577-1471, California) now offers a real-time operating system for 8080/8085 and z80. 
RTOS-80 is compatible with the vendors proFORTH system which is available on the 8550 and 8002A. 

APPLICATION SOFTWARE 

Comm 60 

Holos Corp. (403 West Ponce de Leon Ave., Decatur GA 30030, 404-373-0110) offers a communication package for 
the 8560. Comm 60 is a $1000 general purpose, configurable, communications package connects the 8560 user to a 
remote host such as VAX/VMS or IBM. It offers functions similar to Tektronix' 8540 COM option and 8560 
UNICOM option including downloading object and source files. It is configurable to a variety of hosts via a series 
of prompts for parameters and control characters. A demo version of the product will be available. 
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Nex 

Holos Corp. (404-373-0110) also offers a screen editor for the 8560. Nex is a $800 full-featured screen editor sup- 
porting user-definable commands (KEYMAP) and over 180 terminals. 

Viewcomp 

This spreadsheet is available for the 8560 from UNICORP SW (212-307-6800 New York). Different terminals are 
handled in a way compatible with termcap. The cost is $500; specify 8560 media when ordering. 

Vc 

Software Innovations (603-883-9300 New Hampshire) offers a "visual calculator" for UNIX systems. No 8560 
installations are known yet. 

sees 

Source Code Control System is available for $500 from Santa Cruz Operation (408-425-7222 California). Specify 
8560 media when ordering from SCO. 

UNIX Applications Software 

Andyne Computing (613-548-4356 Ontario) offers UNIX applications like: Menu Presentation Software for 
developing interactive menu systems, RTUTEL to access RT-11 fils on UNIX wih wildcard notation, RTUNEX 
to profile time-critical parts of (resident) C programs, eh? to manage on-line documentation, and net for hierarch- 
ical data management. 

UniPress Software, Inc. (1164 Raritan Ave., Highland Park NJ 08904, 201-985-8000) offers a varied product line 
for UNIX systems. Their offering includes MIMIX (CP/M Emulator), LEX. (word processor), C 8086 compiler, a 
UNIX menu system, UNICALC spreadsheet, and others. 



SOFTWARE PRODUCT REFERENCES 

MDP provides to its sales organization references for third party products. Contact your local Tektronix salesper- 
son for these references. References for these products have been published in MDP's sales newsletter: 



Product 


Target uC 


Host 


Vendor 


Issue 


C 


z80 


8560 


Interactive Systems 


May 83 


proFORTH 


8085/z80 


8002 


Microsystems Inc. 


May 83 


proFORTH 


8085/z80 


8550 


Microsystems Inc. 


May 83 


C 


6809 


8560 


Introl Corp. 


July 83 


C 


68000 


8560 


Alycon 


July 83 


C 


68000 


8560 


Whitesmiths Ltd. 


July 83 


FORTRAN 


8086 


8560 


Virtual Systems 


July 83 


Assembly 


6805 


8560 


Virtual Systems 


July 83 



Tektronix would like to know your appraisal of third party products used with our Microcomputer Development 
Products. This information helps us determine which products deserve a stronger commitment from Tektronix. 
If you want to offer an appraisal, please contact 

Tektronix, Inc. 
MDP Third Party Software 
P.O. Box 4600, M.S. 92-635 
Beaverton OR 97075 
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RUNNING UNIX SOFTWARE ON THE 8560 

PDPll-UNIX software with the following characteristics will, without any change, run on the 8560: 

1. Able to run on UNIX version 7 

2. Able to run in 64K bytes without overlays 

3. Able to run in common instruction & data (I & D) space 

Note: PDP-11 has either separate I & D (eg 11/70) or common I & D (eg 11/23); Much UNIX Software can 
be generated to run in either. 

8560 MEDIA. To install software on the 8560, note these media specs: 

Diskettes 

• IBM-Compatible diskettes, soft sectored 

• Single or double sided, single or double density 

• track 0, side is 128 bytes/sector, FM-encoded, always single density 

• track 0, side 1 is 256 bytes/sector, MFM-encoded 

• tracks 1-76 both sides are 256 bytes each sector 

• In Practice: 

• Any IBM- compatible diskette with 26 sectors/track, single or double sided, either FM* or MFM-encoded, 
can be read. 

• 8560 is sensitive to drive alignment/timing. Use 8560 alignment disc (119-1354-00, Customer Service); 
align on track 38. 

• Formating the disks first on an 8560 increase probability of success 

Sectors 

• TNK treats 2S-2D diskettes as 1995 512-byte blocks; 

IS- ID diskettes as 600 512-byte blocks 

• There is no interleaving and no skewing 

• In Practice: 

• Some floppy controllers can be programmed for no interleave/skew. 

• Otherwise read interleaved, skewed sectors and reorder the data on the 8560. 

File Formats 

tar: same as UNIX v7, found in Auxiliary Utilities Package 

fbr: TNDC only, format documented in 8560 System Ref Manual; 

dsc50: TNDC only, for 8550 transfers, format is internally documented 

others: unreleased utilities to read diskettes from RT-11, ISIS, CP/M and Motorola systems; contact your 
local Tektronix salesperson. 

Rodney Bell MDP Product Marketing Manager 
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SOFTWARE SUBSCRIPTION SERVICE 

Customers who have purchased software subscription service for a product(s) will receive the updated versions as 
performance problems are resolved. 

John Owens MDP Technical Support Manager 



SLOW 8560 OR EXCESS GETTY TIMES 

On a few occasions, poor system performance was observed when little was going on to justify the reduced 
response. When the process status wais displayed, a getty process with a large CPU time was discovered. When 
the process was killed (kill -0 PID) system performance returned to normal. 

One known cause is a terminal (not logged in) which produces a glitch on the DTR line on power up. 

If poor system performance is encountered as described above, simply kill the errant getty process. Note: cron, 
atrun, and swapper will normally accumulate substantial CPU times, do not remove these processes. 

John Owens MDP Technical Support Manager 
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Z8000 ASSEMBLER VERSION 2.0 

Version 2.0 of the Z8000 Assembler for the 8560 (ASMZ8K opt lA) is now available. Version 2.0 includes a vir- 
tual symbol table for user-defined symbols. To assemble code with large number of symbols, add a -b to the invo- 
cation line. 

Marilyn Hanson MDP Product Marketing Manager 



8088 PASCAL/PDB MOD 

The Pascal Compiler (PAS8086 opt lA) and PDB (PDB8086 opt lA) for 8086/8088 have been modded to correct 
bugs reported on these products. These mods do not reflect any enhancements to support the full addressing of 
the processor. Those enhancements will be included in the Version 2 release of the product scheduled for 4th quar- 
ter of FY400. Customers currently subscribed to the Software Subscription Service will receive the mods automat- 
ically. The current version numbers are: 



PAS8086 Version 1.10-05 

PDB8086 Version 1.11-00 



Marilyn Hanson MDP Product Marketing Manager 



4106 POWER UP PROBLEMS 

Some 4105's will not power up when the LED in the "CAPS LOCK" position flashes continuously. 

If this happens, turn off the terminal, remove the ROM access cover on the back of the terminal, and be sure that 
the ROM's are properly seated. 



Gordon Glathar MDP Technical Support 



MDP BUG BASE 

The following product performance reports are contained in our data base. If you have encountered additional 
problems not listed here or in previous issues, please use the product performance report form provided at the end 
of this section. We will keep you informed about the progress toward the solution to the problem. We will also 
try to provide a "work- around" immediately. 

John Owens MDP Technical Support Manager 



8540 ROMPATCH FAILURE 



PRODUCT 

8540 executing rompatch -1 
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CONFIGURATION 

8540 OS-40 version 1 with patch #36 and roms for TTA, COMM (V.-Ol), prom programmer, 8086/8088 and 
68000 (without diags) 

PROBLEM 

With the comm rom (version -01) and all the rom sockets filled, then executing the "rompatch -1" command will 
cause the 8540 to halt. 



NATIVE PROGRAMMIMG TOOLS INSTALLATION 

PRODUCT 

8560 and installing Class C software 

CONFIGURATION 

8560 TNDC version 1.4 and Class C software. Native Programming Package version 1.0 

PROBLEM 

If the Native Programming Package is told "no" to installation of "/usr/include" and "/bin/sed" using the 
"install" command, all commands or files which use "/usr/include" as a dependent file will not be installed. 



DIRECTORY PERMISSIONS OF /USR/INCLUDE/SYS 

PRODUCT 

8560 and accessing /usr/include/sys 

CONFIGURATION 

8560 TNK version 1.4 

PROBLEM 

Only root can execute the directory or contents of /usr/include/sys. 

COMMENTS 

Change attributes of /usr/include/sys from 644 (drw-r— r— ) to 755 (drwxr-xr-x). 

GLOBAL ERROR MESSAGES AND NO GLOBALS 

PRODUCT 

8086 assembler without globals but with global error messages 

CONFIGURATION 

8550 DOS-50 version 2.1, 8086 assembler version 1.01-04 and linker version 2.05 

PROBLEM 

At times, a large 8086 assembler program without declared globals will assemble without errors, but during link- 
ing may generate an error message "undefined global." 
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COMMENT 

The error is caused by overlapping memory areas defined at link invocation. The user should check section size 
versus location definitions. 



PASCAL DEBUG ERROR #70 

PRODUCT 

8086 Pascal Debug with error #79 and internal error 

CONFIGURATION 

8560 TNDC version 1.3, 8086 Pascal compiler version 1.02-04 and 8086 Pascal Debug version 1.07-OOA 

PROBLEM 

At times, the 8086 Pascal Debug will produce error messages (#79 or internal error) without an obvious reason. 

COMMENTS 

This problem is corrected in version PDB8086 VI. 11-00. This version was released Aug. 25. 

16BIT PASCALS SECTION ASSIGNMENT ERROR 

PRODUCT 

16bit Pascal & wrong lib sec. name £ initialized word variable 

CONFIGURATION 

8560 TNDC V1.3 and 16bit pascal compiler 

PROBLEM 

Two sections in the PASCAL library pertaining to floating point computations, have been assigned to the class 
name "DATAQQ". "DATAQQ" contains RAM variable sections. The two sections should have been assigned 
the the class name "CONSTQQ" which contains ROM constants. The incorrectly assigned sections are 
"FPPOIQQ" and ''FPP02QQ." 

COMMENTS The above sections can be explicitly assigned to class name "CONSTQQ" at link invocation. 

6801 EMULATOR MODE SELECT ERROR 

PRODUCT 

6801 emulator and incorrectly reported 6801 mode 

CONFIGURATION 

8550 or 8540 with 6801 emulator and probe 

PROBLEM 

Upon reset, status lines P20, P21 and P22 are sampled by the 6801 to select the mode of operation. Motorola 
recommends lOK pullup resistors on those lines (see the Motorola Data Manual series B, 1981 page 4-95 for 
details). However, the 6801 emulator requires a smaller value pullup resistor in order to insure reliable operation. 
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COMMENTS 

This problem manifests itself in that after user hardware reset the emulator may not report the correct 6801 
mode. 



PASCAL AND REDEFINITION OF IDENTIFIERS 

PRODUCT 

8086, Z8000, 68000 Pascal compilers and identifier 

CONFIGURATION 

8550 DOS-50 version 1.4 or 8560 and TNDC version 1.4 pascal compiler (68000 version l.X, Z8000 version l.X 
8086 Vl.01-07 

PROBLEM 

Redefinition of identifier is not caught. 



PASCAL OPTIMIZER ERROR 

PRODUCT 

Z8000, 68000 and 8086 Pascal compilers and optimization 

CONFIGURATION 

8560 TNDC version 1.4 and pascal compilers (Z8000 version l.Ofl-08, 68000 version 1.01-14, 8086 version 1.04) 

PROBLEM 

Optimization may cause bad code to be generated in some cases. This is only a problem when common sub- 
expressions are of different ordinal type. 

COMMENTS 

The following code shows the sequence of code required to demonstrate the problem. 

type 

intl6 = -32767.. 32767; 
var 

i: intl6; 

j: intl6; 

temp: integer; 
begin 

temp :■■ i; { temp is type integer and i is being } 

i :■« j; { upward coerced from type intl6 to integer } 
j ;=s temp; { the problem will occur here unless there } 
{ is some intervening jumps or breaks } 

{ or the types are changed to the same type } 
end. 

8086 Pascal is fixed in version 1.1; 68000 Pascal version 1.1 is expected soon. 
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8086 PASCAL TRUNCATION OF IDENTIFIERS TO IB CHAR. 

PRODUCT 

8086 Pascal compiler and a maximum of 16 character identifiers 

CONFIGURATION 

8560 TNIX V1.4 or 8550 DOS-60 V2.1 with 8086 Pascal compiler (all versions) 

PROBLEM 

The debug information which the compiler produces for pdb, allows a maximum of 16 characters in an identifier. 
To a user using pdb, any identifiers that are more than 16 characters will not be known by pdb except the 16 
character truncation. 

COMMENTS 

Avoid the problem by limiting identifiers to a maximum of 16 characters. 
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PROBLEM REPORT 



Customer Name 
Company Name 



Date 



-Title. 



Company Address 

Internal Address/Dept 
City 



State 



Area code. 



Tel. No. 



_Zip Code. 
Ext. 



Subscription Service No. 



HARDWARE CONFIGURATION. Include serial number and firmware version numbers. 



SOFTWARE CONFIGURATION. Include version numbers for all involved products and operating system. 



FRODLEM. Include source, results obtained, and results expected. Please submit the minimum source code 
required to demonstrate the problem. Complete documentation will enable us to duplicate the problem. 



COMMENTS. 



Send to: 

MDP Technical Support Manager 

Tektronix Inc 

Del. Station 82-636 

P.O. Box 4600 

Beaverton, Oregon 97075 
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USER GROUP LIBRARY ABSTRACTS 



utility 
8560/61 



ACCOUNT - LOGIN/LOGOUT HISTORY 



MUGL TNIX Vol I 
C 



Abstract 
This utility provides a history of a user's login and logout activity. C source included. 
Author: Jean Paul Bonsang, Tek France 



utility 
8560/61 



ADMIN - DISPLAY LOGIN STATS 



Abstract 



MUGL TNEX Vol I 

shell script 



Displays the last 25 logins and some other system stats by examining the /usr/adm/wtmp file. 
Displays a legend describing what each entry means. 
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ASCII - CONVERTER 

utility MUGL TNK Vol I 

8560/61 C 

Abstract 

This utility simply converts an ascii input string to it s hex, octal, and decimal equivalents. C 
source included. 



ASCIITABLE - PRINTS ASCD CHART 

utility MUGLTNIXVolI 

8560/61 shell script 

Abstract 

This utility shell script prints a nice ascii table showing the full ascii character set along with each 
character's hex and decimal equivalent, both with and without the 8th parity bit set. 

Author: Greg Saville, MDP Marketing 



ASMIT - AUTO FILENAME EXTENSION 

utility MUGL TNIX Vol I 

8500/61 shell script 

Abstract 

This shell script simplifies assembler invocation by providing automatic file extensions of .obj and 
.1st on your object and listing files. You need specify only the core name of your .asm source file, 
and you may run multiple assemblies with a single command line invocation. 



ATS- AT STATUS 

utility MUGLTNIXVolI 

8560/61 shell script 

Abstract 

A shell script to display any jobs scheduled with the at command. You are given the options of exa- 
mining any jobs in the list, and/or deleting if desired. 



ATSTATS - AT STATISTICS 

utility MUGLTNIXVolI 

8560/61 shell script 

Abstract 

This shell script provides a convenient means to examine the status of any jobs scheduled by the at 
command by displaying the associated directories involved with at. 



64 TEKTRONIX September 1983 



USER GROUP NEWS Issue 2 - Vol 2 USER GROUP LfflRARY 



DECIMAL - CONVERTER 

utility MUGL TNIX Vol I 

8560/61 C 

Abstract 

This C program converts decimal input values to their hex, octal, and character equivalents. C 
source included. 



DONUM - DO COMMAND X TIMES 

shell utility TNIX Vol I 

856X shell script 

Abstract 

This shell script executes any command a given number of times. Useful example for use of eval in 
shell scripts to implement variable loop counters. See donum shell script for documentation on use. 



EXTX - EXTRACT TEXT 

utility MUGL TNEX Vol I 

8560/61 C 

Abstract 

C program that extracts and prints ascii character strings from any file. Useful for snooping 
around in object files looking for character strings for undocumented error messages, instructions, 
etc. C source included. 



FDMP - FILE DUMP UTILITY 

utility MUGL TNIX Vol I 

8560/61 C 

Abstract 

Another file dump utility that lets you examine any type file and displays the hex and ascii 
equivalent for each byte. C source included. 

Author: Jean Paul Bonsang, Tek France 



FDUMP - FILEDUMP 

utility MUGL TNIX Vol I 

8560/61 C 

Abstract 
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C program that gives an 8550 fdump style filedump of any given file. Displays hex and ascii values. 
C source included. 



FMAN - FAST MANUAL PAGE COMMAND 

Utility MUGL TNIX Vol I 

8560/61 C 

Abstract 

This program is identical to the standard TNIX man command in function, but the manual content 
is displayed much faster. The command normally displays a page at a time and inquires for next 
page displays. The -n option suppresses the prompting for each page. C source included. 

Author: Jean Paul Bonsang, Tek France 



FMT - LINK LIST FORMATTER 

utility TNIX Vol I 

856X C 

Abstract 

This utility provides a linker listing similar to the one that was available with the Version VI. XX- 
XX linker. Good documentation and well commented C source code included. 

Author: Matthias Dolder, Tek Switzerland 



HELP - PERSONAL COMMANDS HELP 

utility MUGL TNIX Vol! 

8560/61 shell script 

Abstract 

A shell script to put in your .bin directory. When invoked with no command line arguments, it lists 
your personal .bin directory. When invoked with a command line argument, and if that file name 
exists in your .bin directory, then the file is displayed for you. 



HEX - CONVERTER 

utility MUGL TNIX Vol I 

8560/61 C 

Abstract 

Utility to convert hex input values to their hex, octal, and character equivalents. C source 
included. 
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IFIX - INTEL FIX 

utility TNIX Vol I 

856X shell script 

Abstract 

This awk shell script removes the extra line feeds from Intel system files downloaded to the 8560. 
The extra linefeeds result from Intel's use of a cr-If sequence, while TNIX/UNEX uses a single new- 
line character. 



lOC.FORM - FILL OUT' FORM 

nroff utility MUGL TNIX Vol I 

8560/61 fillout form 

Abstract 

This file provides a convenient method of generating Inter Office Communications (IOC or memo) 
input to nroff". Simply edit the ioc.form file with a screen editor such as ace or Ide and 'fill in the 
blanks' to create an nroff ready input file. 

Author: Byron Lunz, MDP Marketing 



LOAD - OBJECT/SYMBOL LOADER 

debug utility MUGL TNIX Vol I 

8560/61 shell script 

Abstract 

This shell script does an object file load, symbol table load, and turns on symbolic debug for you all 
in one command. 



LOG - TERMINAL SESSION LOGGER 

utility MUGL TNIX Vol I 

8560/61 shell script 

Abstract 

This shell script simulates the 8550 log command which allows you to create a file of an entire ter- 
minal session. Useful for documentation purposes or recording of a debug session. 



LOGl - TERMINAL SESSION LOGGER 

utility MUGL TNIX Vol I 

8560/61 shell script 

Abstract 

Another version of a shell script which simulates the 8550 log command. This allows you to create a 
file of an entire terminal session. Useful for documentation purposes or recording of a debug 
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Author: John Owens, MDP Marketing 



LOGGER - PHONE CALL LOGGER 

utility MUGL TNDC Vol I 

8560/61 C 

Abstract 

Nice program for maintaining a log of telephone calls, including who called, date/time, subject, and resolution. 
When invoked with a name, searches through a database for that person and displays their full name, title, and 
location. If not in the database, takes your input directly for the record header. Next, you enter input mode 
where you can explain details of the call, suggestions, solutions, etc. Provides several convenience shorthand 
entry features which may be used if desired. You may also request help during the session and get a summary of 
all the options and commands available in logger. When exiting, the information is appended to the file 'logfile', 
located in your home directory, as well as two other places for administrative purposes. This program is used in 
MDP marketing for maintaining a log of all customer and sales calls which is circulated through the department 
to share the information. The program as is, is set up for use on our machines in marketing, and makes specific 
reference to particular database and destination directories/files. However, since the commented C source is sup- 
plied, it is an easy matter to alter a few definitions and recompile to suit your installation. A manual page is also 
included. 

Author: Jeff Francis, Phoenix FO 



MAILALL - MAIL TO ALL USERS 

utility MUGL TNIX Vol I 

8560/61 shell script 

Abstract 

This shell script simplifies sending the same mail to all users on the system. It examines /etc/ 
passwd and uses sed to extract a user list and then sends the messge to each user. Does take into 
account the fact that you don't normally want to send mail to root, bin, etc. 

Author: Byron Lunz, MDP Marketing 



MAILTO - MAIL TO USERS ON REMOTE SYSTEMS 

shell utility MUGL TNIX Vol I 

856X shell script 

Abstract 

This shell script makes it easy to send mail to users on remote systems without having to remember 
the exact system path for each user. You will need to alter the case statements in the script to 
reflect the paths of the users you frequently send mail to. 

Author: Byron Lunz, MDP Marketing 
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MDSHEX - INTEL SYMBOL LISTER 

utility TNIX Vol I 

856X/Intel MDS/ICE51 shell script, C 

Abstract 

This utility reads an Intel hex file from an MDS with ICE51 and prints a symbol listing and Intel- 
hex file. Requires the Tektronix Intel Vendor Interface Package (VIP) for downloading to 8560. 
Two versions supplied, one a shell script, and the other a well commented C program. 

Author: Matthias Dolder, TEK Switzerland 



M LAB EL- MAIL LABEL PRINTER 

utility MUGL TNIX Vol I 

8560/61 shell script grep/awk 

Abstract 

A shell script using grep and awk which selectively extracts, formats, and prints mailing labels from 
a master database file. The database file consists of records of 8 fields separated by commas con- 
taining the information. The format is documented in a sample database file which is included 
along with the shell source and a .doc file. The script may easily be modified to provide different 
formats for other purposes. 

Author: Greg Saville, MDP Marketing 



MONTH - CALENDAR PRINTER 

utility MUGL TNIX Vol I 

8560/61 shell script 

Abstract 

This utility prints a nice calendar of the current month with the current day blinking in inverse 
video. Handy to put in your .profile to display the date when you login each day. Currently 
designed to work with the Tektronix CT-8500 or 4105 terminals, however the shell script is easily 
modified to work with any other terminal which has blink and/or inverse video attributes. 
Requires the optional TNIX software package, Auxiliary Utilities. 

Author: John Owens, MDP Marketing 



OCTAL - CONVERTER 

utility MUGL TNIX Vol I 

8560/61 shell script 

Abstract 

This C program takes octal numbers as input and displays their hex, decimal, and character 
equivalents. C source included. 
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PATCH - FILE PATCH ROUTINE 

utility MUGLTNLXVolI 

8560/61 C 

Abstract 

This C program allows you to snoop around in any type file, and if invoked in write mode, and if 
you are superuser, and if you think you know what you're doing, allows you to patch the file. This 
can be a very useful program is used with care on a scratch copy of the file you're working with. It 
allows you change anything, even directory entries, so be careful. The program is written in C 
using a menu approach which makes it even easier for the unwary to botch things up. Be careful! 
C source included. 



PROLOG - M900 PROM PROGRAMMER COMMUNICATIONS PROGRAM 

comm utility MUGL TNIX Vol I 

8580/61 C 

Abstract 

This program manages communications between a Prolog MOOD prom programmer and an 8560 
port. The C source is included along with a manual page describing its use. 

Author: Jim Willey, Santa Clara FO 



PRQ - PRINTER QUEUE STATUS 

utility MUGLTNLXVolI 

8560/61 shell script 

Abstract 

Handy shell script which prints the queue for the two spooler directories. Useful for determining 
your position in the queue for your job. 



RESTORE - RESTORE EMU STATUS 

debug utility MUGL TNIX Vol I 

8560/61 shell script 

Abstract 

This shell script provides a convenient method of restoring your emulator setup from a previous 
debug session saved with the 'save' utility. Your memory image is reloaded, registers restored to 
previous values, and the old program counter value is displayed so you may continue right where 
you left off. This version is designed for the Z80 emulator, but may be modified to work with oth- 
ers. Also see the 'save' utility for more information. 

Author: Greg Saville, MDP Marketing 
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SAVE - SAVE DEBUG SESSION 

debug utility MUGL TNIX Vol I 

8560/61 Shell script 

Abstract 

This shell script saves your current 8540 debug status, including a complete memory image and 
current register status. It is useful when you are interrupted or must shutdown, but wish to later 
continue from the same point. You may also wish to create a known starting point from which to 
start several debug runs. This version is designed for the Z80 emulator, but may easily be adapted 
to other emulators. Could easily be expanded to also save your emulation mode, memory map, svc 
status, etc. for later restoration by a similarly expanded 'restore' command. See the 'restore' utility 
for additional information. 

Author: Greg Saville, MDP Marketing 



TELE - TELEPHONE NUMBER 

utility MUGL TNIX Vol I 

8560/61 Shell Script 

Abstract 

Shell script command that uses grep and awk to search through a database of names, addresses, 
and phone numbers and prints the desired person's phone number. Uses the same database format 
as in the mailing label printer, 'mlable'. A sample database file is included. 

Author: Greg Saville, MDP Marketing 



TOOLS - PERSONAL COMMANDS LIST 

Utility MUGL TNIX Vol I 

8560/61 Shell Script 

Abstract 

Simple shell script that conveniently prints a directory of any personal commands you may have 
placed in your .bin directory. 



TR88000 - 68K TRACE FILTER 

debug utility MUGL TNIX Vol I 

8560/61 C 

Abstract 

This program was created by John Simmons, SE Newport News. They do selective filtering of "tra 
all" type output from an emulation session. All read stdin and write to stdout. C source included. 

Author: John Simmons, Newport News FO 
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TRZ80 - Z80 TRACE FILTER 

debug utility MUGL TNIX Vol I 

8560/61 C 

Abstract 

This program was created by John Simmons, SE Newport News. They do selective filtering of "tra 
all" type output from an emulation session. All read stdin and write to stdout. C source included. 

Author: John Simmons, Newport News FO 



TRZ8002 - Z8K TRACE FILTER 

debug utility MUGL TNIX Vol I 

8560/61 C 

Abstract 

This program was created by John Simmons, SE Newport News. They do selective filtering of "tra 
all" type output from an emulation session. All read stdin and write to stdout. C source included. 

Author: John Simmons, Newport News FO 



USPLIT - TEKHEX FILE SPLIT 

utility TNIX Vol I 

856X C 

Abstract 

This program splits a texhex file into two parts, useful for programming eproms where one prom 
has the hi byte, while the other contains the lo byte. See the tpslit.doc and C source files for docu- 
mentation on use. 



VMORE - 'VANILLA MORE' 

utility MUGL TNIX Vol I 

8560/61 C 

Abstract 

A simple version of the standard TNIX 'more' command which pages output to the terminal a 
screenful at a time. Eliminates the problem of trying to ctrl-s/ctrl-q the screen without the text 
flying by. This version, written in C, is designed to work with any 'vanilla' type terminal and 
makes no use of any terminal dependent cursor controls, etc. As such, there are no prompts; a 
screenful is displayed and it waits for you to type a space for the next screen, a carriage return for 
the next line or a q to quit. See the C source and doc files for more information. Designed for 25 
line terminals, but may easily be modified and recompiled for any screen length. Also useful for 
viewing nroflT generated output on a screen, since the standard more trashes the display when over- 
printing and backspacing is used in ioc headers, etc. 

Authors: JefT Francis, Phoenix FO & Greg Saville, MDP Marketing 
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